org.apache.webbeans.proxy

Class InterceptorDecoratorProxyFactory

java.lang.Object

org.apache.webbeans.proxy.AbstractProxyFactory

org.apache.webbeans.proxy.InterceptorDecoratorProxyFactory

public class InterceptorDecoratorProxyFactory
extends AbstractProxyFactory

Generate a dynamic subclass which has exactly 1 delegation point instance which get's set in the Constructor of the proxy. Any non-intercepted or decorated method will get delegated natively, All intercepted and decorated methods will get invoked via an InvocationHandler chain. This factory will create and cache the proxy classes for a given type.

Field Summary

Fields

Modifier and Type	Field and Description
static String	FIELD_INTERCEPTED_METHODS the name of the field which stores the Method[] of all intercepted methods
static String	FIELD_INTERCEPTOR_HANDLER the name of the field which stores the Interceptor + Decorator stack InterceptorHandler
static String	FIELD_PROXIED_INSTANCE the name of the field which stores the proxied instance

Fields inherited from class org.apache.webbeans.proxy.AbstractProxyFactory

FIELD_BEAN_PASSIVATION_ID, MAX_CLASSLOAD_TRIES, webBeansContext

Constructor Summary

Constructors

Constructor and Description
InterceptorDecoratorProxyFactory(WebBeansContext webBeansContext)

Method Summary

Methods

Modifier and Type	Method and Description
protected void	createConstructor(org.apache.xbean.asm4.ClassWriter cw, String proxyClassFileName, Class<?> classToProxy, String classFileName) Each of our interceptor/decorator proxies has exactly 1 constructor which invokes the super ct + sets the delegation field.
protected void	createInstanceVariables(org.apache.xbean.asm4.ClassWriter cw, Class<?> classToProxy, String classFileName) generate the bytecode for creating the instance variables of the class
<T> Class<T>	createProxyClass(javax.enterprise.inject.spi.Bean<T> bean, ClassLoader classLoader, Class<T> classToProxy, Method[] interceptedMethods, Method[] nonInterceptedMethods) Create a decorator and interceptor proxy for the given type.
<T> T	createProxyInstance(Class<? extends T> proxyClass, T instance, InterceptorHandler interceptorDecoratorStack)
protected void	createSerialisation(org.apache.xbean.asm4.ClassWriter cw, String proxyClassFileName, Class<?> classToProxy, String classFileName) generate the bytecode for serialization.
protected void	delegateInterceptedMethods(ClassLoader classLoader, org.apache.xbean.asm4.ClassWriter cw, String proxyClassFileName, Class<?> classToProxy, Method[] interceptedMethods) generate the bytecode for invoking all intercepted methods
protected void	delegateNonInterceptedMethods(ClassLoader classLoader, org.apache.xbean.asm4.ClassWriter cw, String proxyClassFileName, Class<?> classToProxy, Method[] noninterceptedMethods) Directly delegate all non intercepted nor decorated methods to the internal instance.
<T> Class<T>	getCachedProxyClass(javax.enterprise.inject.spi.Bean<T> bean)
InterceptorHandler	getInterceptorHandler(OwbInterceptorProxy proxyInstance)
protected Class	getMarkerInterface()
static <T> T	unwrapInstance(T proxyInstance)

Methods inherited from class org.apache.webbeans.proxy.AbstractProxyFactory

createArrayDefinition, createProxyClass, fixPreservedPackages, generateReturn, getCastType, getPrimitiveMethod, getReturnInsn, getUnusedProxyClassName, getVarInsn, getWrapperType, pushIntOntoStack, pushMethodParameterArray, unproxyableMethod, unsafeNewInstance

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

FIELD_PROXIED_INSTANCE

public static final String FIELD_PROXIED_INSTANCE

the name of the field which stores the proxied instance

See Also:

Constant Field Values

FIELD_INTERCEPTOR_HANDLER

public static final String FIELD_INTERCEPTOR_HANDLER

the name of the field which stores the Interceptor + Decorator stack InterceptorHandler

See Also:

Constant Field Values

FIELD_INTERCEPTED_METHODS

public static final String FIELD_INTERCEPTED_METHODS

the name of the field which stores the Method[] of all intercepted methods

See Also:

Constant Field Values

Constructor Detail

InterceptorDecoratorProxyFactory

public InterceptorDecoratorProxyFactory(WebBeansContext webBeansContext)

Method Detail

createProxyInstance

public <T> T createProxyInstance(Class<? extends T> proxyClass,
                        T instance,
                        InterceptorHandler interceptorDecoratorStack)
                      throws ProxyGenerationException

Throws:

ProxyGenerationException

unwrapInstance

public static <T> T unwrapInstance(T proxyInstance)

Returns:

the internal instance which gets proxied.

getInterceptorHandler

public InterceptorHandler getInterceptorHandler(OwbInterceptorProxy proxyInstance)

Returns:

the internal instance which gets proxied.

createProxyClass

public <T> Class<T> createProxyClass(javax.enterprise.inject.spi.Bean<T> bean,
                            ClassLoader classLoader,
                            Class<T> classToProxy,
                            Method[] interceptedMethods,
                            Method[] nonInterceptedMethods)
                          throws ProxyGenerationException

Create a decorator and interceptor proxy for the given type. A single instance of such a proxy class has exactly one single internal instance.

There are 3 different kind of methods:

1. private methods - they do not get proxied at all! If you like to invoke a private method, then you can use unwrapInstance(Object) and use reflection on it.
2. non-proxied methods - all methods which do not have a business interceptor nor decorator will get delegated to the internal instance without invoking any InterceptorHandler nor doing reflection. Just plain java bytecode will get generated!
3. proxied methods - all calls to such a proxied method will get forwarded to the InterceptorHandler which got set for this instance.

Type Parameters:

T -

Parameters:

bean - the bean the proxy serves for. Needed for caching and serialisation.

classLoader - to use for creating the class in

classToProxy - the class for which a subclass will get generated

interceptedMethods - the list of intercepted or decorated business methods.

nonInterceptedMethods - all methods which are not intercepted nor decorated and shall get delegated directly

Returns:

the proxy class

Throws:

ProxyGenerationException

getCachedProxyClass

public <T> Class<T> getCachedProxyClass(javax.enterprise.inject.spi.Bean<T> bean)

getMarkerInterface

protected Class getMarkerInterface()

Specified by:

getMarkerInterface in class AbstractProxyFactory

Returns:

the marker interface which should be used for this proxy.

createInstanceVariables

protected void createInstanceVariables(org.apache.xbean.asm4.ClassWriter cw,
                           Class<?> classToProxy,
                           String classFileName)

Description copied from class: AbstractProxyFactory

generate the bytecode for creating the instance variables of the class

Specified by:

createInstanceVariables in class AbstractProxyFactory

createSerialisation

protected void createSerialisation(org.apache.xbean.asm4.ClassWriter cw,
                       String proxyClassFileName,
                       Class<?> classToProxy,
                       String classFileName)

Description copied from class: AbstractProxyFactory

generate the bytecode for serialization.

Specified by:

createSerialisation in class AbstractProxyFactory

createConstructor

protected void createConstructor(org.apache.xbean.asm4.ClassWriter cw,
                     String proxyClassFileName,
                     Class<?> classToProxy,
                     String classFileName)
                          throws ProxyGenerationException

Each of our interceptor/decorator proxies has exactly 1 constructor which invokes the super ct + sets the delegation field.

Specified by:

createConstructor in class AbstractProxyFactory

Parameters:

cw -

classToProxy -

classFileName -

Throws:

ProxyGenerationException

delegateNonInterceptedMethods

protected void delegateNonInterceptedMethods(ClassLoader classLoader,
                                 org.apache.xbean.asm4.ClassWriter cw,
                                 String proxyClassFileName,
                                 Class<?> classToProxy,
                                 Method[] noninterceptedMethods)

Directly delegate all non intercepted nor decorated methods to the internal instance.

Specified by:

delegateNonInterceptedMethods in class AbstractProxyFactory

Parameters:

noninterceptedMethods - all methods which are neither intercepted nor decorated

delegateInterceptedMethods

protected void delegateInterceptedMethods(ClassLoader classLoader,
                              org.apache.xbean.asm4.ClassWriter cw,
                              String proxyClassFileName,
                              Class<?> classToProxy,
                              Method[] interceptedMethods)
                                   throws ProxyGenerationException

Description copied from class: AbstractProxyFactory

generate the bytecode for invoking all intercepted methods

Specified by:

delegateInterceptedMethods in class AbstractProxyFactory

Throws:

ProxyGenerationException