public class

BeanNameAutoProxyCreator

extends AbstractAutoProxyCreator

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

Class Overview

Auto proxy creator that identifies beans to proxy via a list of names. Checks for direct, "xxx*", and "*xxx" matches.

For configuration details, see the javadoc of the parent class AbstractAutoProxyCreator. Typically, you will specify a list of interceptor names to apply to all identified beans, via the "interceptorNames" property.

Summary

[Expand]

Inherited Constants

From interface org.springframework.core.Ordered

[Expand]

Inherited Fields

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

Public Constructors
	BeanNameAutoProxyCreator()

Public Methods
void	setBeanNames(String[] beanNames) Set the names of the beans that should automatically get wrapped with proxies.

Protected Methods
Object[]	getAdvicesAndAdvisorsForBean(Class beanClass, String beanName, TargetSource targetSource) Identify as bean to proxy if the bean name is in the configured list of names.
boolean	isMatch(String beanName, String mappedName) Return if the given bean name matches the mapped name.

[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 BeanNameAutoProxyCreator ()

Public Methods

public void setBeanNames (String[] beanNames)

Set the names of the beans that should automatically get wrapped with proxies. A name can specify a prefix to match by ending with "*", e.g. "myBean,tx*" will match the bean named "myBean" and all beans whose name start with "tx".

NOTE: In case of a FactoryBean, only the objects created by the FactoryBean will get proxied. This default behavior applies as of Spring 2.0. If you intend to proxy a FactoryBean instance itself (a rare use case, but Spring 1.2's default behavior), specify the bean name of the FactoryBean including the factory-bean prefix "&": e.g. "&myFactoryBean".

Protected Methods

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

Identify as bean to proxy if the bean name is in the configured list of names.

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 boolean isMatch (String beanName, String mappedName)

Return if the given bean name matches the mapped name.

The default implementation checks for "xxx*", "*xxx" and "*xxx*" matches, as well as direct equality. Can be overridden in subclasses.

Parameters

beanName	the bean name to check
mappedName	the name in the configured list of names

Returns

if the names match

Interfaces

Classes

BeanNameAutoProxyCreator

Class Overview

See Also

Summary

Public Constructors

public BeanNameAutoProxyCreator ()

Public Methods

public void setBeanNames (String[] beanNames)

See Also

Protected Methods

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

Parameters

Returns

protected boolean isMatch (String beanName, String mappedName)

Parameters

Returns

See Also