Spring Framework 6.1.4 · org.springframework.aop.framework.AbstractAdvisingBeanPostProcessor

Modifier and Type	Field and Description
protected Advisor	advisor
protected boolean	beforeExistingAdvisors
private final Map<Class<?>, Boolean>	eligibleBeans

Access	Constructor and Description
public	AbstractAdvisingBeanPostProcessor()

Method Summary

Modifier and Type	Method and Description
protected void	customizeProxyFactory(ProxyFactory the ProxyFactory that is already configured with target, advisor and interfaces and will be used to create the proxy immediately after this method returns proxyFactory) Subclasses may choose to implement this: for example, to change the interfaces exposed.
public Class<?>	determineBeanType(Class<?> the raw class of the bean beanClass, String the name of the bean beanName) Overrides default org.springframework.beans.factory.config.SmartInstantiationAwareBeanPostProcessor.determineBeanType. Determine the type of the bean to be eventually returned from this processor's `postProcessBeforeInstantiation` callback.
protected boolean	isEligible(Object the bean instance bean, String the name of the bean beanName) Check whether the given bean is eligible for advising with this post-processor's `Advisor`.
protected boolean	isEligible(Class<?> the class to check against targetClass) Check whether the given class is eligible for advising with this post-processor's `Advisor`.
public Object	postProcessAfterInitialization(Object the new bean instance bean, String the name of the bean beanName) Overrides default org.springframework.beans.factory.config.BeanPostProcessor.postProcessAfterInitialization. Apply this `BeanPostProcessor` to the given new bean instance after any bean initialization callbacks (like InitializingBean's `afterPropertiesSet` or a custom init-method).
protected ProxyFactory	Returns: the ProxyFactory, initialized with this processor's `ProxyConfig` settings and the specified bean prepareProxyFactory(Object the bean instance to create a proxy for bean, String the corresponding bean name beanName) Prepare a `ProxyFactory` for the given bean.
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.

Inherited from org.springframework.aop.framework.ProxyProcessorSupport:: evaluateProxyInterfaces getOrder getProxyClassLoader isConfigurationCallbackInterface isInternalLanguageInterface setBeanClassLoader setOrder setProxyClassLoader

advisor	back to summary
protected Advisor advisor Annotations @Nullable

beforeExistingAdvisors	back to summary
protected boolean beforeExistingAdvisors

eligibleBeans	back to summary
private final Map<Class<?>, Boolean> eligibleBeans

AbstractAdvisingBeanPostProcessor	back to summary
public AbstractAdvisingBeanPostProcessor()

Method Detail

customizeProxyFactory back to summary

customizeProxyFactory	back to summary
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 the 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`

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: the 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

determineBeanType back to summary

determineBeanType	back to summary
public Class<?> determineBeanType(Class<?> beanClass, String beanName) Overrides default org.springframework.beans.factory.config.SmartInstantiationAwareBeanPostProcessor.determineBeanType. Doc from org.springframework.beans.factory.config.SmartInstantiationAwareBeanPostProcessor.determineBeanType. Determine the type of the bean to be eventually returned from this processor's `postProcessBeforeInstantiation` callback. The default implementation returns the given bean class as-is. Specific implementations should fully evaluate their processing steps in order to create/initialize a potential proxy class upfront. Parameters beanClass:Class<?> the raw class of the bean beanName:String the name of the bean Returns:Class<?> the type of the bean (never `null`) Annotations @Override

public Class<?> determineBeanType(Class<?> beanClass, String beanName)

Overrides default org.springframework.beans.factory.config.SmartInstantiationAwareBeanPostProcessor.determineBeanType.

Doc from org.springframework.beans.factory.config.SmartInstantiationAwareBeanPostProcessor.determineBeanType.

Determine the type of the bean to be eventually returned from this processor's postProcessBeforeInstantiation callback.

The default implementation returns the given bean class as-is. Specific implementations should fully evaluate their processing steps in order to create/initialize a potential proxy class upfront.

Parameters

beanClass:Class<?>: the raw class of the bean
beanName:String: the name of the bean

Returns:Class<?>

the type of the bean (never null)

Annotations

@Override

isEligible back to summary

isEligible	back to summary
protected boolean isEligible(Object bean, 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:Object the bean instance beanName:String the name of the bean See Also `isEligible(Class)`

protected boolean isEligible(Object bean, 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:Object: the bean instance
beanName:String: the name of the bean

See Also

isEligible(Class)

isEligible back to summary

isEligible	back to summary
protected boolean isEligible(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:Class<?> the class to check against See Also `AopUtils#canApply(Advisor, Class)`

protected boolean isEligible(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:Class<?>: the class to check against

See Also

AopUtils#canApply(Advisor, Class)

postProcessAfterInitialization back to summary

postProcessAfterInitialization	back to summary
public Object postProcessAfterInitialization(Object bean, String beanName) Overrides default org.springframework.beans.factory.config.BeanPostProcessor.postProcessAfterInitialization. Doc from org.springframework.beans.factory.config.BeanPostProcessor.postProcessAfterInitialization. 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` method, in contrast to all other `BeanPostProcessor` callbacks. The default implementation returns the given `bean` as-is. Parameters bean:Object the new bean instance beanName:String the name of the bean Returns:Object the bean instance to use, either the original or a wrapped one; if `null`, no subsequent BeanPostProcessors will be invoked Annotations @Override

public Object postProcessAfterInitialization(Object bean, String beanName)

Overrides default org.springframework.beans.factory.config.BeanPostProcessor.postProcessAfterInitialization.

Doc from org.springframework.beans.factory.config.BeanPostProcessor.postProcessAfterInitialization.

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 method, in contrast to all other BeanPostProcessor callbacks.

The default implementation returns the given bean as-is.

Parameters

bean:Object: the new bean instance
beanName:String: the name of the bean

Returns:Object

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

Annotations

@Override

prepareProxyFactory back to summary

prepareProxyFactory	back to summary
protected ProxyFactory prepareProxyFactory(Object bean, 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` allows for late customizations of those parts right before proxy creation. Parameters bean:Object the bean instance to create a proxy for beanName:String the corresponding bean name Returns:ProxyFactory the ProxyFactory, initialized with this processor's `ProxyConfig` settings and the specified bean Since 4.2.3 See Also `customizeProxyFactory`

protected ProxyFactory prepareProxyFactory(Object bean, 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 allows for late customizations of those parts right before proxy creation.

Parameters

bean:Object: the bean instance to create a proxy for
beanName:String: the corresponding bean name

Returns:ProxyFactory

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

Since

4.2.3

See Also

customizeProxyFactory

setBeforeExistingAdvisors	back to summary
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.

setBeforeExistingAdvisors

back to summary

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.

public abstract Class AbstractAdvisingBeanPostProcessor

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail