public abstract class

AbstractAdvisorAutoProxyCreator

extends AbstractAutoProxyCreator

java.lang.Object
↳	org.springframework.aop.framework.ProxyConfig
	↳	org.springframework.aop.framework.autoproxy.AbstractAutoProxyCreator
		↳	org.springframework.aop.framework.autoproxy.AbstractAdvisorAutoProxyCreator

Known Direct Subclasses

AspectJAwareAdvisorAutoProxyCreator, DefaultAdvisorAutoProxyCreator, InfrastructureAdvisorAutoProxyCreator

Known Indirect Subclasses

AnnotationAwareAspectJAutoProxyCreator

Class Overview

Generic auto proxy creator that builds AOP proxies for specific beans based on detected Advisors for each bean.

Subclasses must implement the abstract findCandidateAdvisors() method to return a list of Advisors applying to any object. Subclasses can also override the inherited shouldSkip(Class, String) method to exclude certain objects from auto-proxying.

Advisors or advices requiring ordering should implement the Ordered interface. This class sorts Advisors by Ordered order value. Advisors that don't implement the Ordered interface will be considered as unordered; they will appear at the end of the advisor chain in undefined order.

Summary

[Expand]

Inherited Constants

From interface org.springframework.core.Ordered

[Expand]

Inherited Fields

From class org.springframework.aop.framework.autoproxy.AbstractAutoProxyCreator

Public Constructors
	AbstractAdvisorAutoProxyCreator()

Public Methods
void	setBeanFactory(BeanFactory beanFactory) Callback that supplies the owning factory to a bean instance.

Protected Methods
boolean	advisorsPreFiltered() This auto-proxy creator always returns pre-filtered Advisors.
void	extendAdvisors(List<Advisor> candidateAdvisors) Extension hook that subclasses can override to register additional Advisors, given the sorted Advisors obtained to date.
List<Advisor>	findAdvisorsThatCanApply(List<Advisor> candidateAdvisors, Class beanClass, String beanName) Search the given candidate Advisors to find all Advisors that can apply to the specified bean.
List<Advisor>	findCandidateAdvisors() Find all candidate Advisors to use in auto-proxying.
List<Advisor>	findEligibleAdvisors(Class beanClass, String beanName) Find all eligible Advisors for auto-proxying this class.
Object[]	getAdvicesAndAdvisorsForBean(Class beanClass, String beanName, TargetSource targetSource) Return whether the given bean is to be proxied, what additional advices (e.g.
void	initBeanFactory(ConfigurableListableBeanFactory beanFactory)
boolean	isEligibleAdvisorBean(String beanName) Return whether the Advisor bean with the given name is eligible for proxying in the first place.
List<Advisor>	sortAdvisors(List<Advisor> advisors) Sort advisors based on ordering.

[Expand]

Inherited Methods

From class org.springframework.aop.framework.autoproxy.AbstractAutoProxyCreator

boolean	advisorsPreFiltered() Return whether the Advisors returned by the subclass are pre-filtered to match the bean's target class already, allowing the ClassFilter check to be skipped when building advisors chains for AOP invocations.
Advisor[]	buildAdvisors(String beanName, Object[] specificInterceptors) Determine the advisors for the given bean, including the specific interceptors as well as the common interceptor, all adapted to the Advisor interface.
Object	createProxy(Class<?> beanClass, String beanName, Object[] specificInterceptors, TargetSource targetSource) Create an AOP proxy for the given bean.
void	customizeProxyFactory(ProxyFactory proxyFactory) Subclasses may choose to implement this: for example, to change the interfaces exposed.
Constructor[]<?>	determineCandidateConstructors(Class<?> beanClass, String beanName) Determine the candidate constructors to use for the given bean.
abstract Object[]	getAdvicesAndAdvisorsForBean(Class<?> beanClass, String beanName, TargetSource customTargetSource) Return whether the given bean is to be proxied, what additional advices (e.g.
BeanFactory	getBeanFactory() Return the owning BeanFactory.
Object	getCacheKey(Class<?> beanClass, String beanName) Build a cache key for the given bean class and bean name.
TargetSource	getCustomTargetSource(Class<?> beanClass, String beanName) Create a target source for bean instances.
Object	getEarlyBeanReference(Object bean, String beanName) Obtain a reference for early access to the specified bean, typically for the purpose of resolving a circular reference.
final int	getOrder() Return the order value of this object, with a higher value meaning greater in terms of sorting.
boolean	isFrozen() Return whether the config is frozen, and no advice changes can be made.
boolean	isInfrastructureClass(Class<?> beanClass) Return whether the given bean class represents an infrastructure class that should never be proxied.
Object	postProcessAfterInitialization(Object bean, String beanName) Create a proxy with the configured interceptors if the bean is identified as one to proxy by the subclass.
boolean	postProcessAfterInstantiation(Object bean, String beanName) Perform operations after the bean has been instantiated, via a constructor or factory method, but before Spring property population (from explicit properties or autowiring) occurs.
Object	postProcessBeforeInitialization(Object bean, String beanName) Apply this BeanPostProcessor to the given new bean instance before any bean initialization callbacks (like InitializingBean's `afterPropertiesSet` or a custom init-method).
Object	postProcessBeforeInstantiation(Class<?> beanClass, String beanName) Apply this BeanPostProcessor before the target bean gets instantiated.
PropertyValues	postProcessPropertyValues(PropertyValues pvs, PropertyDescriptor[] pds, Object bean, String beanName) Post-process the given property values before the factory applies them to the given bean.
Class<?>	predictBeanType(Class<?> beanClass, String beanName) Predict the type of the bean to be eventually returned from this processor's `postProcessBeforeInstantiation(Class, String)` callback.
void	setAdvisorAdapterRegistry(AdvisorAdapterRegistry advisorAdapterRegistry) Specify the AdvisorAdapterRegistry to use.
void	setApplyCommonInterceptorsFirst(boolean applyCommonInterceptorsFirst) Set whether the common interceptors should be applied before bean-specific ones.
void	setBeanClassLoader(ClassLoader classLoader) Callback that supplies the bean `class loader` to a bean instance.
void	setBeanFactory(BeanFactory beanFactory) Callback that supplies the owning factory to a bean instance.
void	setCustomTargetSourceCreators(TargetSourceCreator[] targetSourceCreators) Set custom TargetSourceCreators to be applied in this order.
void	setFrozen(boolean frozen) Set whether or not the proxy should be frozen, preventing advice from being added to it once it is created.
void	setInterceptorNames(String[] interceptorNames) Set the common interceptors.
final void	setOrder(int order) Set the ordering which will apply to this class's implementation of Ordered, used when applying multiple BeanPostProcessors.
void	setProxyClassLoader(ClassLoader classLoader) Set the ClassLoader to generate the proxy class in.
boolean	shouldProxyTargetClass(Class<?> beanClass, String beanName) Determine whether the given bean should be proxied with its target class rather than its interfaces.
boolean	shouldSkip(Class<?> beanClass, String beanName) Subclasses should override this method to return `true` if the given bean should not be considered for auto-proxying by this post-processor.
Object	wrapIfNecessary(Object bean, String beanName, Object cacheKey) Wrap the given bean if necessary, i.e.

From class org.springframework.aop.framework.ProxyConfig

void	copyFrom(ProxyConfig other) Copy configuration from the other config object.
boolean	isExposeProxy() Return whether the AOP proxy will expose the AOP proxy for each invocation.
boolean	isFrozen() Return whether the config is frozen, and no advice changes can be made.
boolean	isOpaque() Return whether proxies created by this configuration should be prevented from being cast to `Advised`.
boolean	isOptimize() Return whether proxies should perform aggressive optimizations.
boolean	isProxyTargetClass() Return whether to proxy the target class directly as well as any interfaces.
void	setExposeProxy(boolean exposeProxy) Set whether the proxy should be exposed by the AOP framework as a ThreadLocal for retrieval via the AopContext class.
void	setFrozen(boolean frozen) Set whether this config should be frozen.
void	setOpaque(boolean opaque) Set whether proxies created by this configuration should be prevented from being cast to `Advised` to query proxy status.
void	setOptimize(boolean optimize) Set whether proxies should perform aggressive optimizations.
void	setProxyTargetClass(boolean proxyTargetClass) Set whether to proxy the target class directly, instead of just proxying specific interfaces.
String	toString()

From class java.lang.Object

From interface org.springframework.beans.factory.BeanClassLoaderAware

From interface org.springframework.beans.factory.BeanFactoryAware

From interface org.springframework.beans.factory.config.BeanPostProcessor

From interface org.springframework.beans.factory.config.InstantiationAwareBeanPostProcessor

From interface org.springframework.beans.factory.config.SmartInstantiationAwareBeanPostProcessor

From interface org.springframework.core.Ordered

Public Constructors

public AbstractAdvisorAutoProxyCreator ()

Public Methods

public void setBeanFactory (BeanFactory beanFactory)

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 afterPropertiesSet() or a custom init-method.

Parameters

beanFactory	owning BeanFactory (never `null`). The bean can immediately call methods on the factory.

Protected Methods

protected boolean advisorsPreFiltered ()

This auto-proxy creator always returns pre-filtered Advisors.

Returns

whether the Advisors are pre-filtered

protected void extendAdvisors (List<Advisor> candidateAdvisors)

Extension hook that subclasses can override to register additional Advisors, given the sorted Advisors obtained to date.

The default implementation is empty.

Typically used to add Advisors that expose contextual information required by some of the later advisors.

Parameters

candidateAdvisors	Advisors that have already been identified as applying to a given bean

protected List<Advisor> findAdvisorsThatCanApply (List<Advisor> candidateAdvisors, Class beanClass, String beanName)

Search the given candidate Advisors to find all Advisors that can apply to the specified bean.

Parameters

candidateAdvisors	the candidate Advisors
beanClass	the target's bean class
beanName	the target's bean name

Returns

the List of applicable Advisors

protected List<Advisor> findCandidateAdvisors ()

Find all candidate Advisors to use in auto-proxying.

Returns

the List of candidate Advisors

protected List<Advisor> findEligibleAdvisors (Class beanClass, String beanName)

Find all eligible Advisors for auto-proxying this class.

Parameters

beanClass	the clazz to find advisors for
beanName	the name of the currently proxied bean

Returns

the empty List, not null, if there are no pointcuts or interceptors

protected Object[] getAdvicesAndAdvisorsForBean (Class beanClass, String beanName, TargetSource targetSource)

Return whether the given bean is to be proxied, what additional advices (e.g. AOP Alliance interceptors) and advisors to apply.

Parameters

beanClass	the class of the bean to advise
beanName	the name of the bean
targetSource	the TargetSource returned by the `getCustomTargetSource(Class, String)` method: may be ignored. Will be `null` if no custom target source is in use.

Returns

an array of additional interceptors for the particular bean; or an empty array if no additional interceptors but just the common ones; or null if no proxy at all, not even with the common interceptors. See constants DO_NOT_PROXY and PROXY_WITHOUT_ADDITIONAL_INTERCEPTORS.

protected void initBeanFactory (ConfigurableListableBeanFactory beanFactory)

protected boolean isEligibleAdvisorBean (String beanName)

Return whether the Advisor bean with the given name is eligible for proxying in the first place.

Parameters

beanName	the name of the Advisor bean

Returns

whether the bean is eligible

protected List<Advisor> sortAdvisors (List<Advisor> advisors)

Sort advisors based on ordering. Subclasses may choose to override this method to customize the sorting strategy.

Parameters

advisors	the source List of Advisors

Returns

the sorted List of Advisors

Interfaces

Classes

AbstractAdvisorAutoProxyCreator

Class Overview

See Also

Summary

Public Constructors

public AbstractAdvisorAutoProxyCreator ()

Public Methods

public void setBeanFactory (BeanFactory beanFactory)

Parameters

Protected Methods

protected boolean advisorsPreFiltered ()

Returns

protected void extendAdvisors (List<Advisor> candidateAdvisors)

Parameters

protected List<Advisor> findAdvisorsThatCanApply (List<Advisor> candidateAdvisors, Class beanClass, String beanName)

Parameters

Returns

See Also

protected List<Advisor> findCandidateAdvisors ()

Returns

protected List<Advisor> findEligibleAdvisors (Class beanClass, String beanName)

Parameters

Returns

See Also

protected Object[] getAdvicesAndAdvisorsForBean (Class beanClass, String beanName, TargetSource targetSource)

Parameters

Returns

protected void initBeanFactory (ConfigurableListableBeanFactory beanFactory)

protected boolean isEligibleAdvisorBean (String beanName)

Parameters

Returns

protected List<Advisor> sortAdvisors (List<Advisor> advisors)

Parameters

Returns

See Also