org.springframework.context.annotation

Class ConfigurationClassEnhancer

java.lang.Object

org.springframework.context.annotation.ConfigurationClassEnhancer

class ConfigurationClassEnhancer
extends java.lang.Object

Enhances Configuration classes by generating a CGLIB subclass which interacts with the Spring container to respect bean scoping semantics for @Bean methods. Each such @Bean method will be overridden in the generated subclass, only delegating to the actual @Bean method implementation if the container actually requests the construction of a new instance. Otherwise, a call to such an @Bean method serves as a reference back to the container, obtaining the corresponding bean by name.

Since:

3.0

Author:

Chris Beams, Juergen Hoeller

See Also:

enhance(java.lang.Class<?>, java.lang.ClassLoader), ConfigurationClassPostProcessor

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	ConfigurationClassEnhancer.BeanFactoryAwareGeneratorStrategy Custom extension of CGLIB's DefaultGeneratorStrategy, introducing a BeanFactory field.
private static class	ConfigurationClassEnhancer.BeanFactoryAwareMethodInterceptor Intercepts the invocation of any BeanFactoryAware.setBeanFactory(BeanFactory) on @Configuration class instances for the purpose of recording the BeanFactory.
private static class	ConfigurationClassEnhancer.BeanMethodInterceptor Intercepts the invocation of any Bean-annotated methods in order to ensure proper handling of bean semantics such as scoping and AOP proxying.
private static interface	ConfigurationClassEnhancer.ConditionalCallback Conditional Callback.
private static class	ConfigurationClassEnhancer.ConditionalCallbackFilter A CallbackFilter that works by interrogating Callbacks in the order that they are defined via ConfigurationClassEnhancer.ConditionalCallback.
static interface	ConfigurationClassEnhancer.EnhancedConfiguration Marker interface to be implemented by all @Configuration CGLIB subclasses.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	BEAN_FACTORY_FIELD
private static ConfigurationClassEnhancer.ConditionalCallbackFilter	CALLBACK_FILTER
private static Callback[]	CALLBACKS
private static Log	logger
private static SpringObjenesis	objenesis

Constructor Summary

Constructors

Constructor and Description
ConfigurationClassEnhancer()

Method Summary

Modifier and Type	Method and Description
private java.lang.Class<?>	createClass(Enhancer enhancer) Uses enhancer to generate a subclass of superclass, ensuring that callbacks are registered for the new subclass.
java.lang.Class<?>	enhance(java.lang.Class<?> configClass, java.lang.ClassLoader classLoader) Loads the specified class and generates a CGLIB subclass of it equipped with container-aware callbacks capable of respecting scoping and other bean semantics.
private Enhancer	newEnhancer(java.lang.Class<?> superclass, java.lang.ClassLoader classLoader) Creates a new CGLIB Enhancer instance.

Methods inherited from class java.lang.Object

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

Field Detail

CALLBACKS

private static final Callback[] CALLBACKS

CALLBACK_FILTER

private static final ConfigurationClassEnhancer.ConditionalCallbackFilter CALLBACK_FILTER

BEAN_FACTORY_FIELD

private static final java.lang.String BEAN_FACTORY_FIELD

See Also:

Constant Field Values

logger

private static final Log logger

objenesis

private static final SpringObjenesis objenesis

Constructor Detail

ConfigurationClassEnhancer

ConfigurationClassEnhancer()

Method Detail

enhance

public java.lang.Class<?> enhance(java.lang.Class<?> configClass,
                                  java.lang.ClassLoader classLoader)

Loads the specified class and generates a CGLIB subclass of it equipped with container-aware callbacks capable of respecting scoping and other bean semantics.

Returns:

the enhanced subclass

newEnhancer

private Enhancer newEnhancer(java.lang.Class<?> superclass,
                             java.lang.ClassLoader classLoader)

Creates a new CGLIB Enhancer instance.

createClass

private java.lang.Class<?> createClass(Enhancer enhancer)

Uses enhancer to generate a subclass of superclass, ensuring that callbacks are registered for the new subclass.