org.proxy4j.core

Interface ProxyFactory

All Known Implementing Classes:

BaseProxyFactory, CglibProxyFactory, JavassistProxyFactory, JdkProxyFactory

public interface ProxyFactory

A factory interface for creating different types of proxies.

Since:

1.0

Author:

Brennan Spies

Method Summary

Methods

Modifier and Type	Method and Description
<T> InterceptorBuilder<T>	buildInterceptor(Class<T> proxyClass) Creates a new builder for constructing an interceptor or "protection" proxy.
Object	createProxy(Class<?>[] proxyInterfaces, ProxyHandler<?> handler) Creates a proxy that implements multiple interfaces where invocations on that proxy are passed to a single invoke method on the ProxyHandler.
<T> T	createProxy(Class<T> proxyClass, javax.inject.Provider<T> provider) Creates a "virtual" proxy where method invocations on the proxy are delegated to the provided instance.
<T> T	createProxy(Class<T> proxyClass, ProxyHandler<T> handler) Creates a proxy where method invocations on the proxy are passed to a single invoke method on the ProxyHandler.
<T> T	createProxy(Class<T> proxyClass, T target, Class<? extends Annotation> marker, org.aopalliance.intercept.MethodInterceptor... interceptors) Creates a "protection" proxy where method invocations on the proxy are intercepted by the chain of MethodInterceptors before (optionally) being invoked on the target.

Method Detail

createProxy

<T> T createProxy(Class<T> proxyClass,
                javax.inject.Provider<T> provider)
              throws GenerationException

Creates a "virtual" proxy where method invocations on the proxy are delegated to the provided instance.

Type Parameters:

T - The proxy type

Parameters:

proxyClass - The proxied class

provider - The provider of the proxied object

Returns:

The proxy

Throws:

GenerationException - If an error occurs creating the proxy

createProxy

<T> T createProxy(Class<T> proxyClass,
                ProxyHandler<T> handler)
              throws GenerationException

Creates a proxy where method invocations on the proxy are passed to a single invoke method on the ProxyHandler.

Type Parameters:

T - The proxy type

Parameters:

proxyClass - The proxied interface class

handler - The handler for the method invocation

Returns:

The proxy

Throws:

GenerationException - If an error occurs creating the proxy

createProxy

Object createProxy(Class<?>[] proxyInterfaces,
                 ProxyHandler<?> handler)
                   throws GenerationException

Creates a proxy that implements multiple interfaces where invocations on that proxy are passed to a single invoke method on the ProxyHandler. Equivalent to the traditional JDK proxy creation method: Proxy.newProxyInstance(ClassLoader, Class[], java.lang.reflect.InvocationHandler).

Parameters:

proxyInterfaces - The interfaces that the proxy class must implement

handler - The handler for the method invocation

Returns:

The proxy

Throws:

GenerationException - If an error occurs creating the proxy

createProxy

<T> T createProxy(Class<T> proxyClass,
                T target,
                Class<? extends Annotation> marker,
                org.aopalliance.intercept.MethodInterceptor... interceptors)
              throws GenerationException

Creates a "protection" proxy where method invocations on the proxy are intercepted by the chain of MethodInterceptors before (optionally) being invoked on the target.

Type Parameters:

T - The proxy type

Parameters:

proxyClass - The proxy class

target - The target of the invocation

marker - The annotation that marks intercepted methods

interceptors - One or more method interceptors, which are called in order

Returns:

The proxy

Throws:

GenerationException - If an error occurs creating the proxy

buildInterceptor

<T> InterceptorBuilder<T> buildInterceptor(Class<T> proxyClass)

Creates a new builder for constructing an interceptor or "protection" proxy. The builder allows fine-grained customization of how the target's methods are intercepted.

Type Parameters:

T - The proxy type

Parameters:

proxyClass - The class of the proxy (and target)

Returns:

The builder