org.hibernate.tool.instrument.cglib: public class: InstrumentTask

org.hibernate.tool.instrument.cglib
public class: InstrumentTask [javadoc | source]

java.lang.Object
   org.apache.tools.ant.ProjectComponent
      org.apache.tools.ant.Task
         org.hibernate.tool.instrument.BasicInstrumentationTask
            org.hibernate.tool.instrument.cglib.InstrumentTask

All Implemented Interfaces:
Cloneable

An Ant task for instrumenting persistent classes in order to enable field-level interception using CGLIB.

In order to use this task, typically you would define a a taskdef similiar to:

where lib.class.path is an ANT path reference containing all the required Hibernate and CGLIB libraries.

And then use it like:

...

where the nested ANT fileset includes the class you would like to have instrumented.

Optionally you can chose to enable "Extended Instrumentation" if desired by specifying the extended attriubute on the task:

...

See the Hibernate manual regarding this option.

author: Gavin - King

author: Steve - Ebersole

Fields inherited from org.hibernate.tool.instrument.BasicInstrumentationTask:
logger

Method from org.hibernate.tool.instrument.cglib.InstrumentTask Summary:
getClassDescriptor, getClassTransformer

Methods from org.hibernate.tool.instrument.BasicInstrumentationTask:
addFileset, checkMagic, execute, filesets, getClassDescriptor, getClassTransformer, isBeingIntrumented, isClassFile, isExtended, isJarFile, isVerbose, processClassFile, processFile, processJarFile, setExtended, setVerbose

Methods from org.apache.tools.ant.Task:
bindToOwner, execute, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, init, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType

Methods from org.apache.tools.ant.ProjectComponent:
clone, getDescription, getLocation, getProject, log, log, setDescription, setLocation, setProject

Methods from java.lang.Object:
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from org.hibernate.tool.instrument.cglib.InstrumentTask Detail:
protected ClassDescriptor getClassDescriptor(byte[] byecode) throws Exception { return new CustomClassDescriptor( byecode ); }
protected ClassTransformer getClassTransformer(ClassDescriptor descriptor) { if ( descriptor.isInstrumented() ) { logger.verbose( "class [" + descriptor.getName() + "] already instrumented" ); return null; } else { return provider.getTransformer( CLASS_FILTER, new CustomFieldFilter( descriptor ) ); } }

Method from org.hibernate.tool.instrument.cglib.InstrumentTask Detail:

 protected ClassDescriptor getClassDescriptor(byte[] byecode) throws Exception {
	      
		return new CustomClassDescriptor( byecode );
}

 protected ClassTransformer getClassTransformer(ClassDescriptor descriptor) {
		if ( descriptor.isInstrumented() ) {
			logger.verbose( "class [" + descriptor.getName() + "] already instrumented" );
			return null;
		}
		else {
			return provider.getTransformer( CLASS_FILTER, new CustomFieldFilter( descriptor ) );
		}
}