类 ProxyFactoryBean
- java.lang.Object
- org.springframework.aop.framework.ProxyConfig
- org.springframework.aop.framework.AdvisedSupport
- org.springframework.aop.framework.ProxyCreatorSupport
- org.springframework.aop.framework.ProxyFactoryBean
- 所有已实现的接口:
Serializable
,Advised
,TargetClassAware
,Aware
,BeanClassLoaderAware
,BeanFactoryAware
,FactoryBean<Object>
public class ProxyFactoryBean extends ProxyCreatorSupport implements FactoryBean<Object>, BeanClassLoaderAware, BeanFactoryAware
FactoryBean
implementation that builds an AOP proxy based on beans in SpringBeanFactory
.MethodInterceptors
andAdvisors
are identified by a list of bean names in the current bean factory, specified through the "interceptorNames" property. The last entry in the list can be the name of a target bean or aTargetSource
; however, it is normally preferable to use the "targetName"/"target"/"targetSource" properties instead.Global interceptors and advisors can be added at the factory level. The specified ones are expanded in an interceptor list where an "xxx*" entry is included in the list, matching the given prefix with the bean names (e.g. "global*" would match both "globalBean1" and "globalBean2", "*" all defined interceptors). The matching interceptors get applied according to their returned order value, if they implement the
Ordered
interface.Creates a JDK proxy when proxy interfaces are given, and a CGLIB proxy for the actual target class if not. Note that the latter will only work if the target class does not have final methods, as a dynamic subclass will be created at runtime.
It's possible to cast a proxy obtained from this factory to
Advised
, or to obtain the ProxyFactoryBean reference and programmatically manipulate it. This won't work for existing prototype references, which are independent. However, it will work for prototypes subsequently obtained from the factory. Changes to interception will work immediately on singletons (including existing references). However, to change interfaces or target it's necessary to obtain a new instance from the factory. This means that singleton instances obtained from the factory do not have the same object identity. However, they do have the same interceptors and target, and changing any reference will change all objects.- 作者:
- Rod Johnson, Juergen Hoeller
- 另请参阅:
setInterceptorNames(java.lang.String...)
,setProxyInterfaces(java.lang.Class<?>[])
,MethodInterceptor
,Advisor
,Advised
, 序列化表格
字段概要
字段 修饰符和类型 字段 说明 static String
GLOBAL_SUFFIX
This suffix in a value in an interceptor list indicates to expand globals.protected Log
logger
从类继承的字段 org.springframework.aop.framework.AdvisedSupport
EMPTY_TARGET_SOURCE
构造器概要
构造器 构造器 说明 ProxyFactoryBean()
方法概要
所有方法 实例方法 具体方法 修饰符和类型 方法 说明 protected void
adviceChanged()
Blow away and recache singleton on an advice change.protected Class<?>
createCompositeInterface(Class<?>[] interfaces)
Create a composite interface Class for the given interfaces, implementing the given interfaces in one single Class.Object
getObject()
Return a proxy.Class<?>
getObjectType()
Return the type of the proxy.protected Object
getProxy(AopProxy aopProxy)
Return the proxy object to expose.boolean
isSingleton()
Is the object managed by this factory a singleton?void
setAdvisorAdapterRegistry(AdvisorAdapterRegistry advisorAdapterRegistry)
Specify the AdvisorAdapterRegistry to use.void
setAutodetectInterfaces(boolean autodetectInterfaces)
Set whether to autodetect proxy interfaces if none specified.void
setBeanClassLoader(ClassLoader classLoader)
Callback that supplies the beanclass loader
to a bean instance.void
setBeanFactory(BeanFactory beanFactory)
Callback that supplies the owning factory to a bean instance.void
setFrozen(boolean frozen)
Set whether this config should be frozen.void
setInterceptorNames(String... interceptorNames)
Set the list of Advice/Advisor bean names.void
setProxyClassLoader(ClassLoader classLoader)
Set the ClassLoader to generate the proxy class in.void
setProxyInterfaces(Class<?>[] proxyInterfaces)
Set the names of the interfaces we're proxying.void
setSingleton(boolean singleton)
Set the value of the singleton property.void
setTargetName(String targetName)
Set the name of the target bean.从类继承的方法 org.springframework.aop.framework.ProxyCreatorSupport
addListener, createAopProxy, getAopProxyFactory, isActive, removeListener, setAopProxyFactory
从类继承的方法 org.springframework.aop.framework.AdvisedSupport
addAdvice, addAdvice, addAdvisor, addAdvisor, addAdvisors, addAdvisors, addInterface, adviceIncluded, copyConfigurationFrom, copyConfigurationFrom, countAdvicesOfType, getAdvisorChainFactory, getAdvisors, getAdvisorsInternal, getInterceptorsAndDynamicInterceptionAdvice, getProxiedInterfaces, getTargetClass, getTargetSource, indexOf, indexOf, isInterfaceProxied, isPreFiltered, removeAdvice, removeAdvisor, removeAdvisor, removeInterface, replaceAdvisor, setAdvisorChainFactory, setInterfaces, setPreFiltered, setTarget, setTargetClass, setTargetSource, toProxyConfigString, toString, updateAdvisorArray
从类继承的方法 org.springframework.aop.framework.ProxyConfig
copyFrom, isExposeProxy, isFrozen, isOpaque, isOptimize, isProxyTargetClass, setExposeProxy, setOpaque, setOptimize, setProxyTargetClass
从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
从接口继承的方法 org.springframework.aop.framework.Advised
isExposeProxy, isFrozen, isProxyTargetClass, setExposeProxy
字段详细资料
GLOBAL_SUFFIX
public static final String GLOBAL_SUFFIX
This suffix in a value in an interceptor list indicates to expand globals.- 另请参阅:
- 常量字段值
构造器详细资料
ProxyFactoryBean
public ProxyFactoryBean()
方法详细资料
setProxyInterfaces
public void setProxyInterfaces(Class<?>[] proxyInterfaces) throws ClassNotFoundException
Set the names of the interfaces we're proxying. If no interface is given, a CGLIB for the actual class will be created.This is essentially equivalent to the "setInterfaces" method, but mirrors TransactionProxyFactoryBean's "setProxyInterfaces".
setInterceptorNames
public void setInterceptorNames(String... interceptorNames)
Set the list of Advice/Advisor bean names. This must always be set to use this factory bean in a bean factory.The referenced beans should be of type Interceptor, Advisor or Advice The last entry in the list can be the name of any bean in the factory. If it's neither an Advice nor an Advisor, a new SingletonTargetSource is added to wrap it. Such a target bean cannot be used if the "target" or "targetSource" or "targetName" property is set, in which case the "interceptorNames" array must contain only Advice/Advisor bean names.
NOTE: Specifying a target bean as final name in the "interceptorNames" list is deprecated and will be removed in a future Spring version. Use the
"targetName"
property instead.
setTargetName
public void setTargetName(String targetName)
Set the name of the target bean. This is an alternative to specifying the target name at the end of the "interceptorNames" array.You can also specify a target object or a TargetSource object directly, via the "target"/"targetSource" property, respectively.
setAutodetectInterfaces
public void setAutodetectInterfaces(boolean autodetectInterfaces)
Set whether to autodetect proxy interfaces if none specified.Default is "true". Turn this flag off to create a CGLIB proxy for the full target class if no interfaces specified.
setSingleton
public void setSingleton(boolean singleton)
Set the value of the singleton property. Governs whether this factory should always return the same proxy instance (which implies the same target) or whether it should return a new prototype instance, which implies that the target and interceptors may be new instances also, if they are obtained from prototype bean definitions. This allows for fine control of independence/uniqueness in the object graph.
setAdvisorAdapterRegistry
public void setAdvisorAdapterRegistry(AdvisorAdapterRegistry advisorAdapterRegistry)
Specify the AdvisorAdapterRegistry to use. Default is the global AdvisorAdapterRegistry.
setFrozen
public void setFrozen(boolean frozen)
从类复制的说明:ProxyConfig
Set whether this config should be frozen.When a config is frozen, no advice changes can be made. This is useful for optimization, and useful when we don't want callers to be able to manipulate configuration after casting to Advised.
- 覆盖:
setFrozen
在类中ProxyConfig
setProxyClassLoader
public void setProxyClassLoader(ClassLoader classLoader)
Set the ClassLoader to generate the proxy class in.Default is the bean ClassLoader, i.e. the ClassLoader used by the containing BeanFactory for loading all bean classes. This can be overridden here for specific proxies.
setBeanClassLoader
public void setBeanClassLoader(ClassLoader classLoader)
从接口复制的说明:BeanClassLoaderAware
Callback that supplies the beanclass loader
to a bean instance.Invoked after the population of normal bean properties but before an initialization callback such as
InitializingBean's
InitializingBean.afterPropertiesSet()
method or a custom init-method.- 指定者:
setBeanClassLoader
在接口中BeanClassLoaderAware
- 参数:
classLoader
- the owning class loader; may benull
in which case a defaultClassLoader
must be used, for example theClassLoader
obtained viaClassUtils.getDefaultClassLoader()
setBeanFactory
public void setBeanFactory(BeanFactory beanFactory)
从接口复制的说明:BeanFactoryAware
Callback that supplies the owning factory to a bean instance.Invoked after the population of normal bean properties but before an initialization callback such as
InitializingBean.afterPropertiesSet()
or a custom init-method.- 指定者:
setBeanFactory
在接口中BeanFactoryAware
- 参数:
beanFactory
- owning BeanFactory (nevernull
). The bean can immediately call methods on the factory.- 另请参阅:
BeanInitializationException
getObject
public Object getObject() throws BeansException
Return a proxy. Invoked when clients obtain beans from this factory bean. Create an instance of the AOP proxy to be returned by this factory. The instance will be cached for a singleton, and create on each call togetObject()
for a proxy.- 指定者:
getObject
在接口中FactoryBean<Object>
- 返回:
- a fresh AOP proxy reflecting the current state of this factory
- 抛出:
BeansException
- 另请参阅:
FactoryBeanNotInitializedException
getObjectType
public Class<?> getObjectType()
Return the type of the proxy. Will check the singleton instance if already created, else fall back to the proxy interface (in case of just a single one), the target bean type, or the TargetSource's target class.- 指定者:
getObjectType
在接口中FactoryBean<Object>
- 返回:
- the type of object that this FactoryBean creates, or
null
if not known at the time of the call - 另请参阅:
TargetSource.getTargetClass()
isSingleton
public boolean isSingleton()
从接口复制的说明:FactoryBean
Is the object managed by this factory a singleton? That is, willFactoryBean.getObject()
always return the same object (a reference that can be cached)?NOTE: If a FactoryBean indicates to hold a singleton object, the object returned from
getObject()
might get cached by the owning BeanFactory. Hence, do not returntrue
unless the FactoryBean always exposes the same reference.The singleton status of the FactoryBean itself will generally be provided by the owning BeanFactory; usually, it has to be defined as singleton there.
NOTE: This method returning
false
does not necessarily indicate that returned objects are independent instances. An implementation of the extendedSmartFactoryBean
interface may explicitly indicate independent instances through itsSmartFactoryBean.isPrototype()
method. PlainFactoryBean
implementations which do not implement this extended interface are simply assumed to always return independent instances if theisSingleton()
implementation returnsfalse
.- 指定者:
isSingleton
在接口中FactoryBean<Object>
- 返回:
- whether the exposed object is a singleton
- 另请参阅:
FactoryBean.getObject()
,SmartFactoryBean.isPrototype()
createCompositeInterface
protected Class<?> createCompositeInterface(Class<?>[] interfaces)
Create a composite interface Class for the given interfaces, implementing the given interfaces in one single Class.The default implementation builds a JDK proxy class for the given interfaces.
- 参数:
interfaces
- the interfaces to merge- 返回:
- the merged interface as Class
- 另请参阅:
Proxy.getProxyClass(java.lang.ClassLoader, java.lang.Class<?>...)
getProxy
protected Object getProxy(AopProxy aopProxy)
Return the proxy object to expose.The default implementation uses a
getProxy
call with the factory's bean class loader. Can be overridden to specify a custom class loader.- 参数:
aopProxy
- the prepared AopProxy instance to get the proxy from- 返回:
- the proxy object to expose
- 另请参阅:
AopProxy.getProxy(ClassLoader)
adviceChanged
protected void adviceChanged()
Blow away and recache singleton on an advice change.