org.springframework.aop.framework
Class ProxyFactory

java.lang.Object
  org.springframework.aop.framework.ProxyConfig
      org.springframework.aop.framework.AdvisedSupport
          org.springframework.aop.framework.ProxyFactory

All Implemented Interfaces:

Serializable, Advised, AopProxy

public class ProxyFactory
extends AdvisedSupport
implements AopProxy

Factory for AOP proxies for programmatic use, rather than via a bean factory. This class provides a simple way of obtaining and configuring AOP proxies in code.

Since:

14.03.2003

Author:

Rod Johnson, Rob Harrop

See Also:

Serialized Form

Field Summary

Fields inherited from class org.springframework.aop.framework.AdvisedSupport

advisorChainFactory, EMPTY_TARGET_SOURCE, targetSource

Fields inherited from class org.springframework.aop.framework.ProxyConfig

exposeProxy, logger

Constructor Summary

ProxyFactory()
Create a new ProxyFactory.

ProxyFactory(Class[] interfaces)
Create a new ProxyFactory.

ProxyFactory(Object target)
Create a new ProxyFactory.

Method Summary

Object	getProxy() Create a new proxy according to the settings in this factory.
static Object	getProxy(Class proxyInterface, Interceptor interceptor) Create a new proxy for the given interface and interceptor.
Object	getProxy(ClassLoader classLoader) Create a new proxy according to the settings in this factory.
static Object	getProxy(Class proxyInterface, TargetSource targetSource) Create a proxy for the specified TargetSource that implements the specified interface.
static Object	getProxy(TargetSource targetSource) Create a proxy for the specified TargetSource that extends the target class of the TargetSource.

Methods inherited from class org.springframework.aop.framework.AdvisedSupport

addAdvice, addAdvice, addAdvisor, addAdvisor, addAdvisor, addAllAdvisors, addInterface, addListener, adviceChanged, adviceIncluded, copyConfigurationFrom, copyConfigurationFrom, countAdvicesOfType, createAopProxy, getAdvisorChainFactory, getAdvisors, getAdvisorsInternal, getProxiedInterfaces, getTargetSource, indexOf, indexOf, isActive, isInterfaceProxied, removeAdvice, removeAdvisor, removeAdvisor, removeInterface, removeListener, replaceAdvisor, setAdvisorChainFactory, setInterfaces, setTarget, setTargetSource, toProxyConfigString, toString, updateAdvisorArray, writeReplace

Methods inherited from class org.springframework.aop.framework.ProxyConfig

copyFrom, getAopProxyFactory, isExposeProxy, isFrozen, isOpaque, isOptimize, isProxyTargetClass, setAopProxyFactory, setExposeProxy, setFrozen, setOpaque, setOptimize, setProxyTargetClass

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.aop.framework.Advised

isExposeProxy, isFrozen, isProxyTargetClass, setExposeProxy

Constructor Detail

ProxyFactory

public ProxyFactory()

Create a new ProxyFactory.

ProxyFactory

public ProxyFactory(Object target)
             throws AopConfigException

Create a new ProxyFactory.

Will proxy all interfaces of the given target.

Parameters:

target - the target object that is to be proxied

Throws:

AopConfigException - if the supplied target object is null

ProxyFactory

public ProxyFactory(Class[] interfaces)

Create a new ProxyFactory. No target, only interfaces. Must add interceptors.

Method Detail

getProxy

public Object getProxy()

Create a new proxy according to the settings in this factory. Can be called repeatedly. Effect will vary if we've added or removed interfaces. Can add and remove interceptors.

Uses a default class loader: Usually, the thread context class loader (if necessary for proxy creation).

Specified by:

getProxy in interface AopProxy

Returns:

the new proxy

See Also:

Thread.getContextClassLoader()

getProxy

public Object getProxy(ClassLoader classLoader)

Create a new proxy according to the settings in this factory. Can be called repeatedly. Effect will vary if we've added or removed interfaces. Can add and remove interceptors.

Uses the given class loader (if necessary for proxy creation).

Specified by:

getProxy in interface AopProxy

Parameters:

classLoader - the class loader to create the proxy with

Returns:

the new proxy

getProxy

public static Object getProxy(Class proxyInterface,
                              Interceptor interceptor)

Create a new proxy for the given interface and interceptor.

Convenience method for creating a proxy for a single interceptor, assuming that the interceptor handles all calls itself rather than delegating to a target, like in the case of remoting proxies.

Parameters:

proxyInterface - the interface that the proxy should implement

interceptor - the interceptor that the proxy should invoke

Returns:

the new proxy

getProxy

public static Object getProxy(Class proxyInterface,
                              TargetSource targetSource)

Create a proxy for the specified TargetSource that implements the specified interface.

getProxy

public static Object getProxy(TargetSource targetSource)

Create a proxy for the specified TargetSource that extends the target class of the TargetSource.