Class Enhancer
- java.lang.Object
-
- net.sf.cglib.core.AbstractClassGenerator
-
- net.sf.cglib.proxy.Enhancer
-
- All Implemented Interfaces:
ClassGenerator
public class Enhancer extends AbstractClassGenerator
Generates dynamic subclasses to enable method interception. This class started as a substitute for the standard Dynamic Proxy support included with JDK 1.3, but one that allowed the proxies to extend a concrete base class, in addition to implementing interfaces. The dynamically generated subclasses override the non-final methods of the superclass and have hooks which callback to user-defined interceptor implementations.The original and most general callback type is the
MethodInterceptor
, which in AOP terms enables "around advice"--that is, you can invoke custom code both before and after the invocation of the "super" method. In addition you can modify the arguments before calling the super method, or not call it at all.Although
MethodInterceptor
is generic enough to meet any interception need, it is often overkill. For simplicity and performance, additional specialized callback types, such asLazyLoader
are also available. Often a single callback will be used per enhanced class, but you can control which callback is used on a per-method basis with aCallbackFilter
.The most common uses of this class are embodied in the static helper methods. For advanced needs, such as customizing the
ClassLoader
to use, you should create a new instance ofEnhancer
. Other classes within CGLIB follow a similar pattern.All enhanced objects implement the
Factory
interface, unlesssetUseFactory(boolean)
is used to explicitly disable this feature. TheFactory
interface provides an API to change the callbacks of an existing object, as well as a faster and easier way to create new instances of the same type.For an almost drop-in replacement for
java.lang.reflect.Proxy
, see theProxy
class.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description (package private) static class
Enhancer.EnhancerFactoryData
The idea of the class is to cache relevant java.lang.reflect instances so proxy-class can be instantiated faster that when usingReflectUtils.newInstance(Class, Class[], Object[])
andsetThreadCallbacks(Class, Callback[])
static interface
Enhancer.EnhancerKey
Internal interface, only public due to ClassLoader issues.-
Nested classes/interfaces inherited from class net.sf.cglib.core.AbstractClassGenerator
AbstractClassGenerator.ClassLoaderData, AbstractClassGenerator.Source
-
-
Field Summary
Fields Modifier and Type Field Description private static CallbackFilter
ALL_ZERO
private java.lang.Object[]
arguments
private java.lang.Class[]
argumentTypes
private static Signature
BIND_CALLBACKS
private static java.lang.String
BOUND_FIELD
private static org.objectweb.asm.Type
CALLBACK
private static org.objectweb.asm.Type
CALLBACK_ARRAY
private static java.lang.String
CALLBACK_FILTER_FIELD
AbstractClassGenerator.ClassLoaderData.generatedClasses
requires to keep cache key in a good shape (the keys should be up and running if the proxy class is alive), and one of the cache keys isCallbackFilter
.private Callback[]
callbacks
private org.objectweb.asm.Type[]
callbackTypes
private boolean
classOnly
private static java.lang.String
CONSTRUCTED_FIELD
private static Signature
CSTRUCT_NULL
private Enhancer.EnhancerFactoryData
currentData
private java.lang.Object
currentKey
private static org.objectweb.asm.Type
FACTORY
private static java.lang.String
FACTORY_DATA_FIELD
private CallbackFilter
filter
private static Signature
GET_CALLBACK
private static Signature
GET_CALLBACKS
private static org.objectweb.asm.Type
ILLEGAL_ARGUMENT_EXCEPTION
private static org.objectweb.asm.Type
ILLEGAL_STATE_EXCEPTION
private boolean
interceptDuringConstruction
private java.lang.Class[]
interfaces
private static Enhancer.EnhancerKey
KEY_FACTORY
private static Signature
MULTIARG_NEW_INSTANCE
private static Signature
NEW_INSTANCE
private static org.objectweb.asm.Type
OBJECT_TYPE
private java.lang.Long
serialVersionUID
private static Signature
SET_CALLBACK
private static Signature
SET_CALLBACKS
private static Signature
SET_STATIC_CALLBACKS
private static java.lang.String
SET_STATIC_CALLBACKS_NAME
private static Signature
SET_THREAD_CALLBACKS
private static java.lang.String
SET_THREAD_CALLBACKS_NAME
private static Signature
SINGLE_NEW_INSTANCE
private static AbstractClassGenerator.Source
SOURCE
private static java.lang.String
STATIC_CALLBACKS_FIELD
private java.lang.Class
superclass
private static java.lang.String
THREAD_CALLBACKS_FIELD
private static org.objectweb.asm.Type
THREAD_LOCAL
private static Signature
THREAD_LOCAL_GET
private static Signature
THREAD_LOCAL_SET
private boolean
useFactory
private boolean
validateCallbackTypes
-
Constructor Summary
Constructors Constructor Description Enhancer()
Create a newEnhancer
.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description java.lang.Object
create()
Generate a new class if necessary and uses the specified callbacks (if any) to create a new object instance.java.lang.Object
create(java.lang.Class[] argumentTypes, java.lang.Object[] arguments)
Generate a new class if necessary and uses the specified callbacks (if any) to create a new object instance.static java.lang.Object
create(java.lang.Class superclass, java.lang.Class[] interfaces, Callback callback)
Helper method to create an intercepted object.static java.lang.Object
create(java.lang.Class superclass, java.lang.Class[] interfaces, CallbackFilter filter, Callback[] callbacks)
Helper method to create an intercepted object.static java.lang.Object
create(java.lang.Class type, Callback callback)
Helper method to create an intercepted object.java.lang.Class
createClass()
Generate a new class if necessary and return it without creating a new instance.private java.lang.Object
createHelper()
private java.lang.Object
createUsingReflection(java.lang.Class type)
Instantiates a proxy instance and assigns callback values.private void
emitBindCallbacks(ClassEmitter ce)
private void
emitCommonNewInstance(CodeEmitter e)
private void
emitConstructors(ClassEmitter ce, java.util.List constructors)
private void
emitCurrentCallback(CodeEmitter e, int index)
private void
emitDefaultConstructor(ClassEmitter ce)
private void
emitGetCallback(ClassEmitter ce, int[] keys)
private void
emitGetCallbacks(ClassEmitter ce)
private void
emitMethods(ClassEmitter ce, java.util.List methods, java.util.List actualMethods)
private void
emitNewInstanceCallback(ClassEmitter ce)
private void
emitNewInstanceCallbacks(ClassEmitter ce)
private void
emitNewInstanceMultiarg(ClassEmitter ce, java.util.List constructors)
private void
emitSetCallback(ClassEmitter ce, int[] keys)
private void
emitSetCallbacks(ClassEmitter ce)
private void
emitSetStaticCallbacks(ClassEmitter ce)
private void
emitSetThreadCallbacks(ClassEmitter ce)
protected void
filterConstructors(java.lang.Class sc, java.util.List constructors)
Filter the list of constructors from the superclass.protected java.lang.Object
firstInstance(java.lang.Class type)
This method should not be called in regular flow.protected java.lang.Class
generate(AbstractClassGenerator.ClassLoaderData data)
void
generateClass(org.objectweb.asm.ClassVisitor v)
private static java.lang.String
getCallbackField(int index)
private int[]
getCallbackKeys()
private static java.lang.reflect.Method
getCallbacksSetter(java.lang.Class type, java.lang.String methodName)
protected java.lang.ClassLoader
getDefaultClassLoader()
static void
getMethods(java.lang.Class superclass, java.lang.Class[] interfaces, java.util.List methods)
Finds all of the methods that will be extended by an Enhancer-generated class using the specified superclass and interfaces.private static void
getMethods(java.lang.Class superclass, java.lang.Class[] interfaces, java.util.List methods, java.util.List interfaceMethods, java.util.Set forcePublic)
protected java.security.ProtectionDomain
getProtectionDomain()
Returns the protection domain to use when defining the class.private org.objectweb.asm.Type
getThisType(CodeEmitter e)
static boolean
isEnhanced(java.lang.Class type)
Determine if a class was generated usingEnhancer
.protected java.lang.Object
nextInstance(java.lang.Object instance)
private void
preValidate()
static void
registerCallbacks(java.lang.Class generatedClass, Callback[] callbacks)
Call this method to register theCallback
array to use before creating a new instance of the generated class via reflection.static void
registerStaticCallbacks(java.lang.Class generatedClass, Callback[] callbacks)
Similar toregisterCallbacks(java.lang.Class, net.sf.cglib.proxy.Callback[])
, but suitable for use when multiple threads will be creating instances of the generated class.private Signature
rename(Signature sig, int index)
void
setCallback(Callback callback)
Set the singleCallback
to use.void
setCallbackFilter(CallbackFilter filter)
Set theCallbackFilter
used to map the generated class' methods to a particular callback index.void
setCallbacks(Callback[] callbacks)
Set the array of callbacks to use.private static void
setCallbacksHelper(java.lang.Class type, Callback[] callbacks, java.lang.String methodName)
void
setCallbackType(java.lang.Class callbackType)
Set the single type ofCallback
to use.void
setCallbackTypes(java.lang.Class[] callbackTypes)
Set the array of callback types to use.void
setInterceptDuringConstruction(boolean interceptDuringConstruction)
Set whether methods called from within the proxy's constructer will be intercepted.void
setInterfaces(java.lang.Class[] interfaces)
Set the interfaces to implement.void
setSerialVersionUID(java.lang.Long sUID)
Insert a static serialVersionUID field into the generated class.void
setSuperclass(java.lang.Class superclass)
Set the class which the generated class will extend.private static void
setThreadCallbacks(java.lang.Class type, Callback[] callbacks)
void
setUseFactory(boolean useFactory)
Set whether the enhanced object instances should implement theFactory
interface.protected java.lang.Object
unwrapCachedValue(java.lang.Object cached)
private void
validate()
protected java.lang.Object
wrapCachedClass(java.lang.Class klass)
-
Methods inherited from class net.sf.cglib.core.AbstractClassGenerator
create, getAttemptLoad, getClassLoader, getClassName, getCurrent, getNamingPolicy, getStrategy, getUseCache, setAttemptLoad, setClassLoader, setNamePrefix, setNamingPolicy, setStrategy, setUseCache
-
-
-
-
Field Detail
-
ALL_ZERO
private static final CallbackFilter ALL_ZERO
-
SOURCE
private static final AbstractClassGenerator.Source SOURCE
-
KEY_FACTORY
private static final Enhancer.EnhancerKey KEY_FACTORY
-
BOUND_FIELD
private static final java.lang.String BOUND_FIELD
- See Also:
- Constant Field Values
-
FACTORY_DATA_FIELD
private static final java.lang.String FACTORY_DATA_FIELD
- See Also:
- Constant Field Values
-
THREAD_CALLBACKS_FIELD
private static final java.lang.String THREAD_CALLBACKS_FIELD
- See Also:
- Constant Field Values
-
STATIC_CALLBACKS_FIELD
private static final java.lang.String STATIC_CALLBACKS_FIELD
- See Also:
- Constant Field Values
-
SET_THREAD_CALLBACKS_NAME
private static final java.lang.String SET_THREAD_CALLBACKS_NAME
- See Also:
- Constant Field Values
-
SET_STATIC_CALLBACKS_NAME
private static final java.lang.String SET_STATIC_CALLBACKS_NAME
- See Also:
- Constant Field Values
-
CONSTRUCTED_FIELD
private static final java.lang.String CONSTRUCTED_FIELD
- See Also:
- Constant Field Values
-
CALLBACK_FILTER_FIELD
private static final java.lang.String CALLBACK_FILTER_FIELD
AbstractClassGenerator.ClassLoaderData.generatedClasses
requires to keep cache key in a good shape (the keys should be up and running if the proxy class is alive), and one of the cache keys isCallbackFilter
. That is why the generated class contains static field that keeps strong reference to thefilter
.This dance achieves two goals: ensures generated class is reusable and available through generatedClasses cache, and it enables to unload classloader and the related
CallbackFilter
in case user does not need that- See Also:
- Constant Field Values
-
OBJECT_TYPE
private static final org.objectweb.asm.Type OBJECT_TYPE
-
FACTORY
private static final org.objectweb.asm.Type FACTORY
-
ILLEGAL_STATE_EXCEPTION
private static final org.objectweb.asm.Type ILLEGAL_STATE_EXCEPTION
-
ILLEGAL_ARGUMENT_EXCEPTION
private static final org.objectweb.asm.Type ILLEGAL_ARGUMENT_EXCEPTION
-
THREAD_LOCAL
private static final org.objectweb.asm.Type THREAD_LOCAL
-
CALLBACK
private static final org.objectweb.asm.Type CALLBACK
-
CALLBACK_ARRAY
private static final org.objectweb.asm.Type CALLBACK_ARRAY
-
CSTRUCT_NULL
private static final Signature CSTRUCT_NULL
-
SET_THREAD_CALLBACKS
private static final Signature SET_THREAD_CALLBACKS
-
SET_STATIC_CALLBACKS
private static final Signature SET_STATIC_CALLBACKS
-
NEW_INSTANCE
private static final Signature NEW_INSTANCE
-
MULTIARG_NEW_INSTANCE
private static final Signature MULTIARG_NEW_INSTANCE
-
SINGLE_NEW_INSTANCE
private static final Signature SINGLE_NEW_INSTANCE
-
SET_CALLBACK
private static final Signature SET_CALLBACK
-
GET_CALLBACK
private static final Signature GET_CALLBACK
-
SET_CALLBACKS
private static final Signature SET_CALLBACKS
-
GET_CALLBACKS
private static final Signature GET_CALLBACKS
-
THREAD_LOCAL_GET
private static final Signature THREAD_LOCAL_GET
-
THREAD_LOCAL_SET
private static final Signature THREAD_LOCAL_SET
-
BIND_CALLBACKS
private static final Signature BIND_CALLBACKS
-
currentData
private Enhancer.EnhancerFactoryData currentData
-
currentKey
private java.lang.Object currentKey
-
interfaces
private java.lang.Class[] interfaces
-
filter
private CallbackFilter filter
-
callbacks
private Callback[] callbacks
-
callbackTypes
private org.objectweb.asm.Type[] callbackTypes
-
validateCallbackTypes
private boolean validateCallbackTypes
-
classOnly
private boolean classOnly
-
superclass
private java.lang.Class superclass
-
argumentTypes
private java.lang.Class[] argumentTypes
-
arguments
private java.lang.Object[] arguments
-
useFactory
private boolean useFactory
-
serialVersionUID
private java.lang.Long serialVersionUID
-
interceptDuringConstruction
private boolean interceptDuringConstruction
-
-
Constructor Detail
-
Enhancer
public Enhancer()
Create a newEnhancer
. A newEnhancer
object should be used for each generated object, and should not be shared across threads. To create additional instances of a generated class, use theFactory
interface.- See Also:
Factory
-
-
Method Detail
-
setSuperclass
public void setSuperclass(java.lang.Class superclass)
Set the class which the generated class will extend. As a convenience, if the supplied superclass is actually an interface,setInterfaces
will be called with the appropriate argument instead. A non-interface argument must not be declared as final, and must have an accessible constructor.- Parameters:
superclass
- class to extend or interface to implement- See Also:
setInterfaces(Class[])
-
setInterfaces
public void setInterfaces(java.lang.Class[] interfaces)
Set the interfaces to implement. TheFactory
interface will always be implemented regardless of what is specified here.- Parameters:
interfaces
- array of interfaces to implement, or null- See Also:
Factory
-
setCallbackFilter
public void setCallbackFilter(CallbackFilter filter)
Set theCallbackFilter
used to map the generated class' methods to a particular callback index. New object instances will always use the same mapping, but may use different actual callback objects.- Parameters:
filter
- the callback filter to use when generating a new class- See Also:
setCallbacks(net.sf.cglib.proxy.Callback[])
-
setCallback
public void setCallback(Callback callback)
Set the singleCallback
to use. Ignored if you usecreateClass()
.- Parameters:
callback
- the callback to use for all methods- See Also:
setCallbacks(net.sf.cglib.proxy.Callback[])
-
setCallbacks
public void setCallbacks(Callback[] callbacks)
Set the array of callbacks to use. Ignored if you usecreateClass()
. You must use aCallbackFilter
to specify the index into this array for each method in the proxied class.- Parameters:
callbacks
- the callback array- See Also:
setCallbackFilter(net.sf.cglib.proxy.CallbackFilter)
,setCallback(net.sf.cglib.proxy.Callback)
-
setUseFactory
public void setUseFactory(boolean useFactory)
Set whether the enhanced object instances should implement theFactory
interface. This was added for tools that need for proxies to be more indistinguishable from their targets. Also, in some cases it may be necessary to disable theFactory
interface to prevent code from changing the underlying callbacks.- Parameters:
useFactory
- whether to implementFactory
; default istrue
-
setInterceptDuringConstruction
public void setInterceptDuringConstruction(boolean interceptDuringConstruction)
Set whether methods called from within the proxy's constructer will be intercepted. The default value is true. Unintercepted methods will call the method of the proxy's base class, if it exists.- Parameters:
interceptDuringConstruction
- whether to intercept methods called from the constructor
-
setCallbackType
public void setCallbackType(java.lang.Class callbackType)
Set the single type ofCallback
to use. This may be used instead ofsetCallback(net.sf.cglib.proxy.Callback)
when callingcreateClass()
, since it may not be possible to have an array of actual callback instances.- Parameters:
callbackType
- the type of callback to use for all methods- See Also:
setCallbackTypes(java.lang.Class[])
-
setCallbackTypes
public void setCallbackTypes(java.lang.Class[] callbackTypes)
Set the array of callback types to use. This may be used instead ofsetCallbacks(net.sf.cglib.proxy.Callback[])
when callingcreateClass()
, since it may not be possible to have an array of actual callback instances. You must use aCallbackFilter
to specify the index into this array for each method in the proxied class.- Parameters:
callbackTypes
- the array of callback types
-
create
public java.lang.Object create()
Generate a new class if necessary and uses the specified callbacks (if any) to create a new object instance. Uses the no-arg constructor of the superclass.- Returns:
- a new instance
-
create
public java.lang.Object create(java.lang.Class[] argumentTypes, java.lang.Object[] arguments)
Generate a new class if necessary and uses the specified callbacks (if any) to create a new object instance. Uses the constructor of the superclass matching theargumentTypes
parameter, with the given arguments.- Parameters:
argumentTypes
- constructor signaturearguments
- compatible wrapped arguments to pass to constructor- Returns:
- a new instance
-
createClass
public java.lang.Class createClass()
Generate a new class if necessary and return it without creating a new instance. This ignores any callbacks that have been set. To create a new instance you will have to use reflection, and methods called during the constructor will not be intercepted. To avoid this problem, use the multi-argcreate
method.- See Also:
create(Class[], Object[])
-
setSerialVersionUID
public void setSerialVersionUID(java.lang.Long sUID)
Insert a static serialVersionUID field into the generated class.- Parameters:
sUID
- the field value, or null to avoid generating field.
-
preValidate
private void preValidate()
-
validate
private void validate()
-
createHelper
private java.lang.Object createHelper()
-
generate
protected java.lang.Class generate(AbstractClassGenerator.ClassLoaderData data)
- Overrides:
generate
in classAbstractClassGenerator
-
getDefaultClassLoader
protected java.lang.ClassLoader getDefaultClassLoader()
- Specified by:
getDefaultClassLoader
in classAbstractClassGenerator
-
getProtectionDomain
protected java.security.ProtectionDomain getProtectionDomain()
Description copied from class:AbstractClassGenerator
Returns the protection domain to use when defining the class.Default implementation returns
null
for using a default protection domain. Sub-classes may override to use a more specific protection domain.- Overrides:
getProtectionDomain
in classAbstractClassGenerator
- Returns:
- the protection domain (
null
for using a default)
-
getMethods
public static void getMethods(java.lang.Class superclass, java.lang.Class[] interfaces, java.util.List methods)
Finds all of the methods that will be extended by an Enhancer-generated class using the specified superclass and interfaces. This can be useful in building a list of Callback objects. The methods are added to the end of the given list. Due to the subclassing nature of the classes generated by Enhancer, the methods are guaranteed to be non-static, non-final, and non-private. Each method signature will only occur once, even if it occurs in multiple classes.- Parameters:
superclass
- the class that will be extended, or nullinterfaces
- the list of interfaces that will be implemented, or nullmethods
- the list into which to copy the applicable methods
-
getMethods
private static void getMethods(java.lang.Class superclass, java.lang.Class[] interfaces, java.util.List methods, java.util.List interfaceMethods, java.util.Set forcePublic)
-
generateClass
public void generateClass(org.objectweb.asm.ClassVisitor v) throws java.lang.Exception
- Throws:
java.lang.Exception
-
filterConstructors
protected void filterConstructors(java.lang.Class sc, java.util.List constructors)
Filter the list of constructors from the superclass. The constructors which remain will be included in the generated class. The default implementation is to filter out all private constructors, but subclasses may extend Enhancer to override this behavior.- Parameters:
sc
- the superclassconstructors
- the list of all declared constructors from the superclass- Throws:
java.lang.IllegalArgumentException
- if there are no non-private constructors
-
firstInstance
protected java.lang.Object firstInstance(java.lang.Class type) throws java.lang.Exception
This method should not be called in regular flow. Technically speakingwrapCachedClass(Class)
usesEnhancer.EnhancerFactoryData
as a cache value, and the latter enables faster instantiation than plain old reflection lookup and invoke. This method is left intact for backward compatibility reasons: just in case it was ever used.- Specified by:
firstInstance
in classAbstractClassGenerator
- Parameters:
type
- class to instantiate- Returns:
- newly created proxy instance
- Throws:
java.lang.Exception
- if something goes wrong
-
nextInstance
protected java.lang.Object nextInstance(java.lang.Object instance)
- Specified by:
nextInstance
in classAbstractClassGenerator
-
wrapCachedClass
protected java.lang.Object wrapCachedClass(java.lang.Class klass)
- Overrides:
wrapCachedClass
in classAbstractClassGenerator
-
unwrapCachedValue
protected java.lang.Object unwrapCachedValue(java.lang.Object cached)
- Overrides:
unwrapCachedValue
in classAbstractClassGenerator
-
registerCallbacks
public static void registerCallbacks(java.lang.Class generatedClass, Callback[] callbacks)
Call this method to register theCallback
array to use before creating a new instance of the generated class via reflection. If you are using an instance ofEnhancer
or theFactory
interface to create new instances, this method is unnecessary. Its primary use is for when you want to cache and reuse a generated class yourself, and the generated class does not implement theFactory
interface.Note that this method only registers the callbacks on the current thread. If you want to register callbacks for instances created by multiple threads, use
registerStaticCallbacks(java.lang.Class, net.sf.cglib.proxy.Callback[])
.The registered callbacks are overwritten and subsequently cleared when calling any of the
create
methods (such ascreate()
), or anyFactory
newInstance
method. Otherwise they are not cleared, and you should be careful to set them back tonull
after creating new instances via reflection if memory leakage is a concern.- Parameters:
generatedClass
- a class previously created byEnhancer
callbacks
- the array of callbacks to use when instances of the generated class are created- See Also:
setUseFactory(boolean)
-
registerStaticCallbacks
public static void registerStaticCallbacks(java.lang.Class generatedClass, Callback[] callbacks)
Similar toregisterCallbacks(java.lang.Class, net.sf.cglib.proxy.Callback[])
, but suitable for use when multiple threads will be creating instances of the generated class. The thread-level callbacks will always override the static callbacks. Static callbacks are never cleared.- Parameters:
generatedClass
- a class previously created byEnhancer
callbacks
- the array of callbacks to use when instances of the generated class are created
-
isEnhanced
public static boolean isEnhanced(java.lang.Class type)
Determine if a class was generated usingEnhancer
.- Parameters:
type
- any class- Returns:
- whether the class was generated using
Enhancer
-
setThreadCallbacks
private static void setThreadCallbacks(java.lang.Class type, Callback[] callbacks)
-
setCallbacksHelper
private static void setCallbacksHelper(java.lang.Class type, Callback[] callbacks, java.lang.String methodName)
-
getCallbacksSetter
private static java.lang.reflect.Method getCallbacksSetter(java.lang.Class type, java.lang.String methodName) throws java.lang.NoSuchMethodException
- Throws:
java.lang.NoSuchMethodException
-
createUsingReflection
private java.lang.Object createUsingReflection(java.lang.Class type)
Instantiates a proxy instance and assigns callback values. Implementation detail: java.lang.reflect instances are not cached, so this method should not be used on a hot path. This method is used whenAbstractClassGenerator.setUseCache(boolean)
is set tofalse
.- Parameters:
type
- class to instantiate- Returns:
- newly created instance
-
create
public static java.lang.Object create(java.lang.Class type, Callback callback)
Helper method to create an intercepted object. For finer control over the generated instance, use a new instance ofEnhancer
instead of this static method.- Parameters:
type
- class to extend or interface to implementcallback
- the callback to use for all methods
-
create
public static java.lang.Object create(java.lang.Class superclass, java.lang.Class[] interfaces, Callback callback)
Helper method to create an intercepted object. For finer control over the generated instance, use a new instance ofEnhancer
instead of this static method.- Parameters:
superclass
- class to extend or interface to implementinterfaces
- array of interfaces to implement, or nullcallback
- the callback to use for all methods
-
create
public static java.lang.Object create(java.lang.Class superclass, java.lang.Class[] interfaces, CallbackFilter filter, Callback[] callbacks)
Helper method to create an intercepted object. For finer control over the generated instance, use a new instance ofEnhancer
instead of this static method.- Parameters:
superclass
- class to extend or interface to implementinterfaces
- array of interfaces to implement, or nullfilter
- the callback filter to use when generating a new classcallbacks
- callback implementations to use for the enhanced object
-
emitDefaultConstructor
private void emitDefaultConstructor(ClassEmitter ce)
-
emitConstructors
private void emitConstructors(ClassEmitter ce, java.util.List constructors)
-
getCallbackKeys
private int[] getCallbackKeys()
-
emitGetCallback
private void emitGetCallback(ClassEmitter ce, int[] keys)
-
emitSetCallback
private void emitSetCallback(ClassEmitter ce, int[] keys)
-
emitSetCallbacks
private void emitSetCallbacks(ClassEmitter ce)
-
emitGetCallbacks
private void emitGetCallbacks(ClassEmitter ce)
-
emitNewInstanceCallbacks
private void emitNewInstanceCallbacks(ClassEmitter ce)
-
getThisType
private org.objectweb.asm.Type getThisType(CodeEmitter e)
-
emitCommonNewInstance
private void emitCommonNewInstance(CodeEmitter e)
-
emitNewInstanceCallback
private void emitNewInstanceCallback(ClassEmitter ce)
-
emitNewInstanceMultiarg
private void emitNewInstanceMultiarg(ClassEmitter ce, java.util.List constructors)
-
emitMethods
private void emitMethods(ClassEmitter ce, java.util.List methods, java.util.List actualMethods)
-
emitSetThreadCallbacks
private void emitSetThreadCallbacks(ClassEmitter ce)
-
emitSetStaticCallbacks
private void emitSetStaticCallbacks(ClassEmitter ce)
-
emitCurrentCallback
private void emitCurrentCallback(CodeEmitter e, int index)
-
emitBindCallbacks
private void emitBindCallbacks(ClassEmitter ce)
-
getCallbackField
private static java.lang.String getCallbackField(int index)
-
-