org.springframework.aop.framework

Class AbstractAdvisingBeanPostProcessor

java.lang.Object

org.springframework.aop.framework.ProxyConfig

org.springframework.aop.framework.ProxyProcessorSupport

org.springframework.aop.framework.AbstractAdvisingBeanPostProcessor

All Implemented Interfaces:

java.io.Serializable, AopInfrastructureBean, Aware, BeanClassLoaderAware, BeanPostProcessor, Ordered

Direct Known Subclasses:

AbstractBeanFactoryAwareAdvisingPostProcessor

public abstract class AbstractAdvisingBeanPostProcessor
extends ProxyProcessorSupport
implements BeanPostProcessor

Base class for BeanPostProcessor implementations that apply a Spring AOP Advisor to specific beans.

Since:

3.2

Author:

Juergen Hoeller

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected Advisor	advisor
protected boolean	beforeExistingAdvisors
private java.util.Map<java.lang.Class<?>,java.lang.Boolean>	eligibleBeans

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

exposeProxy, opaque

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
AbstractAdvisingBeanPostProcessor()

Method Summary

Modifier and Type	Method and Description
protected void	customizeProxyFactory(ProxyFactory proxyFactory) Subclasses may choose to implement this: for example, to change the interfaces exposed.
protected boolean	isEligible(java.lang.Class<?> targetClass) Check whether the given class is eligible for advising with this post-processor's Advisor.
protected boolean	isEligible(java.lang.Object bean, java.lang.String beanName) Check whether the given bean is eligible for advising with this post-processor's Advisor.
java.lang.Object	postProcessAfterInitialization(java.lang.Object bean, java.lang.String beanName) Apply this BeanPostProcessor to the given new bean instance after any bean initialization callbacks (like InitializingBean's afterPropertiesSet or a custom init-method).
java.lang.Object	postProcessBeforeInitialization(java.lang.Object bean, java.lang.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).
protected ProxyFactory	prepareProxyFactory(java.lang.Object bean, java.lang.String beanName) Prepare a ProxyFactory for the given bean.
void	setBeforeExistingAdvisors(boolean beforeExistingAdvisors) Set whether this post-processor's advisor is supposed to apply before existing advisors when encountering a pre-advised object.

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

evaluateProxyInterfaces, getOrder, getProxyClassLoader, isConfigurationCallbackInterface, isInternalLanguageInterface, setBeanClassLoader, setOrder, setProxyClassLoader

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

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

Methods inherited from class java.lang.Object

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

Field Detail

advisor

protected Advisor advisor

beforeExistingAdvisors

protected boolean beforeExistingAdvisors

eligibleBeans

private final java.util.Map<java.lang.Class<?>,java.lang.Boolean> eligibleBeans

Constructor Detail

AbstractAdvisingBeanPostProcessor

public AbstractAdvisingBeanPostProcessor()

Method Detail

setBeforeExistingAdvisors

public void setBeforeExistingAdvisors(boolean beforeExistingAdvisors)

Set whether this post-processor's advisor is supposed to apply before existing advisors when encountering a pre-advised object.

Default is "false", applying the advisor after existing advisors, i.e. as close as possible to the target method. Switch this to "true" in order for this post-processor's advisor to wrap existing advisors as well.

Note: Check the concrete post-processor's javadoc whether it possibly changes this flag by default, depending on the nature of its advisor.

postProcessBeforeInitialization

public java.lang.Object postProcessBeforeInitialization(java.lang.Object bean,
                                                        java.lang.String beanName)

Description copied from interface: BeanPostProcessor

Apply this BeanPostProcessor to the given new bean instance before any bean initialization callbacks (like InitializingBean's afterPropertiesSet or a custom init-method). The bean will already be populated with property values. The returned bean instance may be a wrapper around the original.

Specified by:

postProcessBeforeInitialization in interface BeanPostProcessor

Parameters:

bean - the new bean instance

beanName - the name of the bean

Returns:

the bean instance to use, either the original or a wrapped one; if null, no subsequent BeanPostProcessors will be invoked

See Also:

InitializingBean.afterPropertiesSet()

postProcessAfterInitialization

public java.lang.Object postProcessAfterInitialization(java.lang.Object bean,
                                                       java.lang.String beanName)

Description copied from interface: BeanPostProcessor

Apply this BeanPostProcessor to the given new bean instance after any bean initialization callbacks (like InitializingBean's afterPropertiesSet or a custom init-method). The bean will already be populated with property values. The returned bean instance may be a wrapper around the original.

In case of a FactoryBean, this callback will be invoked for both the FactoryBean instance and the objects created by the FactoryBean (as of Spring 2.0). The post-processor can decide whether to apply to either the FactoryBean or created objects or both through corresponding bean instanceof FactoryBean checks.

This callback will also be invoked after a short-circuiting triggered by a InstantiationAwareBeanPostProcessor.postProcessBeforeInstantiation(java.lang.Class<?>, java.lang.String) method, in contrast to all other BeanPostProcessor callbacks.

Specified by:

postProcessAfterInitialization in interface BeanPostProcessor

Parameters:

bean - the new bean instance

beanName - the name of the bean

Returns:

the bean instance to use, either the original or a wrapped one; if null, no subsequent BeanPostProcessors will be invoked

See Also:

InitializingBean.afterPropertiesSet(), FactoryBean

isEligible

protected boolean isEligible(java.lang.Object bean,
                             java.lang.String beanName)

Check whether the given bean is eligible for advising with this post-processor's Advisor.

Delegates to isEligible(Class) for target class checking. Can be overridden e.g. to specifically exclude certain beans by name.

Note: Only called for regular bean instances but not for existing proxy instances which implement Advised and allow for adding the local Advisor to the existing proxy's Advisor chain. For the latter, isEligible(Class) is being called directly, with the actual target class behind the existing proxy (as determined by AopUtils.getTargetClass(Object)).

Parameters:

bean - the bean instance

beanName - the name of the bean

See Also:

isEligible(Class)

isEligible

protected boolean isEligible(java.lang.Class<?> targetClass)

Check whether the given class is eligible for advising with this post-processor's Advisor.

Implements caching of canApply results per bean target class.

Parameters:

targetClass - the class to check against

See Also:

AopUtils.canApply(Advisor, Class)

prepareProxyFactory

protected ProxyFactory prepareProxyFactory(java.lang.Object bean,
                                           java.lang.String beanName)

Prepare a ProxyFactory for the given bean.

Subclasses may customize the handling of the target instance and in particular the exposure of the target class. The default introspection of interfaces for non-target-class proxies and the configured advisor will be applied afterwards; customizeProxyFactory(org.springframework.aop.framework.ProxyFactory) allows for late customizations of those parts right before proxy creation.

Parameters:

bean - the bean instance to create a proxy for

beanName - the corresponding bean name

Returns:

the ProxyFactory, initialized with this processor's ProxyConfig settings and the specified bean

Since:

4.2.3

See Also:

customizeProxyFactory(org.springframework.aop.framework.ProxyFactory)

customizeProxyFactory

protected void customizeProxyFactory(ProxyFactory proxyFactory)

Subclasses may choose to implement this: for example, to change the interfaces exposed.

The default implementation is empty.

Parameters:

proxyFactory - ProxyFactory that is already configured with target, advisor and interfaces and will be used to create the proxy immediately after this method returns

Since:

4.2.3

See Also:

prepareProxyFactory(java.lang.Object, java.lang.String)