org.springframework.test.web.servlet.setup

Class StubWebApplicationContext.StubBeanFactory

java.lang.Object

org.springframework.beans.factory.support.StaticListableBeanFactory

org.springframework.test.web.servlet.setup.StubWebApplicationContext.StubBeanFactory

All Implemented Interfaces:

BeanFactory, AutowireCapableBeanFactory, ListableBeanFactory

Enclosing class:

StubWebApplicationContext

private class StubWebApplicationContext.StubBeanFactory
extends StaticListableBeanFactory
implements AutowireCapableBeanFactory

An extension of StaticListableBeanFactory that implements AutowireCapableBeanFactory in order to allow bean initialization of ApplicationContextAware singletons.

Field Summary

Fields inherited from interface org.springframework.beans.factory.config.AutowireCapableBeanFactory

AUTOWIRE_AUTODETECT, AUTOWIRE_BY_NAME, AUTOWIRE_BY_TYPE, AUTOWIRE_CONSTRUCTOR, AUTOWIRE_NO

Fields inherited from interface org.springframework.beans.factory.BeanFactory

FACTORY_BEAN_PREFIX

Constructor Summary

Constructors

Modifier	Constructor and Description
private	StubBeanFactory()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	applyBeanPostProcessorsAfterInitialization(java.lang.Object existingBean, java.lang.String beanName) Apply BeanPostProcessors to the given existing bean instance, invoking their postProcessAfterInitialization methods.
java.lang.Object	applyBeanPostProcessorsBeforeInitialization(java.lang.Object existingBean, java.lang.String beanName) Apply BeanPostProcessors to the given existing bean instance, invoking their postProcessBeforeInitialization methods.
void	applyBeanPropertyValues(java.lang.Object existingBean, java.lang.String beanName) Apply the property values of the bean definition with the given name to the given bean instance.
java.lang.Object	autowire(java.lang.Class<?> beanClass, int autowireMode, boolean dependencyCheck) Instantiate a new bean instance of the given class with the specified autowire strategy.
void	autowireBean(java.lang.Object existingBean) Populate the given bean instance through applying after-instantiation callbacks and bean property post-processing (e.g.
void	autowireBeanProperties(java.lang.Object existingBean, int autowireMode, boolean dependencyCheck) Autowire the bean properties of the given bean instance by name or type.
java.lang.Object	configureBean(java.lang.Object existingBean, java.lang.String beanName) Configure the given raw bean: autowiring bean properties, applying bean property values, applying factory callbacks such as setBeanName and setBeanFactory, and also applying all bean post processors (including ones which might wrap the given raw bean).
java.lang.Object	createBean(java.lang.Class<?> beanClass, int autowireMode, boolean dependencyCheck) Fully create a new bean instance of the given class with the specified autowire strategy.
<T> T	createBean(java.lang.Class<T> beanClass) Fully create a new bean instance of the given class.
void	destroyBean(java.lang.Object existingBean) Destroy the given bean instance (typically coming from AutowireCapableBeanFactory.createBean(java.lang.Class<T>)), applying the DisposableBean contract as well as registered DestructionAwareBeanPostProcessors.
java.lang.Object	initializeBean(java.lang.Object existingBean, java.lang.String beanName) Initialize the given raw bean, applying factory callbacks such as setBeanName and setBeanFactory, also applying all bean post processors (including ones which might wrap the given raw bean).
java.lang.Object	resolveDependency(DependencyDescriptor descriptor, java.lang.String requestingBeanName) Resolve the specified dependency against the beans defined in this factory.
java.lang.Object	resolveDependency(DependencyDescriptor descriptor, java.lang.String requestingBeanName, java.util.Set<java.lang.String> autowiredBeanNames, TypeConverter typeConverter) Resolve the specified dependency against the beans defined in this factory.
<T> NamedBeanHolder<T>	resolveNamedBean(java.lang.Class<T> requiredType) Resolve the bean instance that uniquely matches the given object type, if any, including its bean name.

Methods inherited from class org.springframework.beans.factory.support.StaticListableBeanFactory

addBean, containsBean, containsBeanDefinition, findAnnotationOnBean, getAliases, getBean, getBean, getBean, getBean, getBean, getBeanDefinitionCount, getBeanDefinitionNames, getBeanNamesForAnnotation, getBeanNamesForType, getBeanNamesForType, getBeanNamesForType, getBeansOfType, getBeansOfType, getBeansWithAnnotation, getType, isPrototype, isSingleton, isTypeMatch, isTypeMatch

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.beans.factory.BeanFactory

containsBean, getAliases, getBean, getBean, getBean, getBean, getBean, getType, isPrototype, isSingleton, isTypeMatch, isTypeMatch

Constructor Detail

StubBeanFactory

private StubBeanFactory()

Method Detail

initializeBean

public java.lang.Object initializeBean(java.lang.Object existingBean,
                                       java.lang.String beanName)
                                throws BeansException

Description copied from interface: AutowireCapableBeanFactory

Initialize the given raw bean, applying factory callbacks such as setBeanName and setBeanFactory, also applying all bean post processors (including ones which might wrap the given raw bean).

Note that no bean definition of the given name has to exist in the bean factory. The passed-in bean name will simply be used for callbacks but not checked against the registered bean definitions.

Specified by:

initializeBean in interface AutowireCapableBeanFactory

Parameters:

existingBean - the existing bean instance

beanName - the name of the bean, to be passed to it if necessary (only passed to BeanPostProcessors)

Returns:

the bean instance to use, either the original or a wrapped one

Throws:

BeansException - if the initialization failed

createBean

public <T> T createBean(java.lang.Class<T> beanClass)

Description copied from interface: AutowireCapableBeanFactory

Fully create a new bean instance of the given class.

Performs full initialization of the bean, including all applicable BeanPostProcessors.

Note: This is intended for creating a fresh instance, populating annotated fields and methods as well as applying all standard bean initialization callbacks. It does not imply traditional by-name or by-type autowiring of properties; use AutowireCapableBeanFactory.createBean(Class, int, boolean) for those purposes.

Specified by:

createBean in interface AutowireCapableBeanFactory

Parameters:

beanClass - the class of the bean to create

Returns:

the new bean instance

createBean

public java.lang.Object createBean(java.lang.Class<?> beanClass,
                                   int autowireMode,
                                   boolean dependencyCheck)

Description copied from interface: AutowireCapableBeanFactory

Fully create a new bean instance of the given class with the specified autowire strategy. All constants defined in this interface are supported here.

Performs full initialization of the bean, including all applicable BeanPostProcessors. This is effectively a superset of what AutowireCapableBeanFactory.autowire(java.lang.Class<?>, int, boolean) provides, adding AutowireCapableBeanFactory.initializeBean(java.lang.Object, java.lang.String) behavior.

Specified by:

createBean in interface AutowireCapableBeanFactory

Parameters:

beanClass - the class of the bean to create

autowireMode - by name or type, using the constants in this interface

dependencyCheck - whether to perform a dependency check for objects (not applicable to autowiring a constructor, thus ignored there)

Returns:

the new bean instance

See Also:

AutowireCapableBeanFactory.AUTOWIRE_NO, AutowireCapableBeanFactory.AUTOWIRE_BY_NAME, AutowireCapableBeanFactory.AUTOWIRE_BY_TYPE, AutowireCapableBeanFactory.AUTOWIRE_CONSTRUCTOR

autowire

public java.lang.Object autowire(java.lang.Class<?> beanClass,
                                 int autowireMode,
                                 boolean dependencyCheck)

Description copied from interface: AutowireCapableBeanFactory

Instantiate a new bean instance of the given class with the specified autowire strategy. All constants defined in this interface are supported here. Can also be invoked with AUTOWIRE_NO in order to just apply before-instantiation callbacks (e.g. for annotation-driven injection).

Does not apply standard BeanPostProcessors callbacks or perform any further initialization of the bean. This interface offers distinct, fine-grained operations for those purposes, for example AutowireCapableBeanFactory.initializeBean(java.lang.Object, java.lang.String). However, InstantiationAwareBeanPostProcessor callbacks are applied, if applicable to the construction of the instance.

Specified by:

autowire in interface AutowireCapableBeanFactory

Parameters:

beanClass - the class of the bean to instantiate

autowireMode - by name or type, using the constants in this interface

dependencyCheck - whether to perform a dependency check for object references in the bean instance (not applicable to autowiring a constructor, thus ignored there)

Returns:

the new bean instance

See Also:

AutowireCapableBeanFactory.AUTOWIRE_NO, AutowireCapableBeanFactory.AUTOWIRE_BY_NAME, AutowireCapableBeanFactory.AUTOWIRE_BY_TYPE, AutowireCapableBeanFactory.AUTOWIRE_CONSTRUCTOR, AutowireCapableBeanFactory.AUTOWIRE_AUTODETECT, AutowireCapableBeanFactory.initializeBean(java.lang.Object, java.lang.String), AutowireCapableBeanFactory.applyBeanPostProcessorsBeforeInitialization(java.lang.Object, java.lang.String), AutowireCapableBeanFactory.applyBeanPostProcessorsAfterInitialization(java.lang.Object, java.lang.String)

autowireBean

public void autowireBean(java.lang.Object existingBean)
                  throws BeansException

Description copied from interface: AutowireCapableBeanFactory

Populate the given bean instance through applying after-instantiation callbacks and bean property post-processing (e.g. for annotation-driven injection).

Note: This is essentially intended for (re-)populating annotated fields and methods, either for new instances or for deserialized instances. It does not imply traditional by-name or by-type autowiring of properties; use AutowireCapableBeanFactory.autowireBeanProperties(java.lang.Object, int, boolean) for those purposes.

Specified by:

autowireBean in interface AutowireCapableBeanFactory

Parameters:

existingBean - the existing bean instance

Throws:

BeansException - if wiring failed

autowireBeanProperties

public void autowireBeanProperties(java.lang.Object existingBean,
                                   int autowireMode,
                                   boolean dependencyCheck)

Description copied from interface: AutowireCapableBeanFactory

Autowire the bean properties of the given bean instance by name or type. Can also be invoked with AUTOWIRE_NO in order to just apply after-instantiation callbacks (e.g. for annotation-driven injection).

Does not apply standard BeanPostProcessors callbacks or perform any further initialization of the bean. This interface offers distinct, fine-grained operations for those purposes, for example AutowireCapableBeanFactory.initializeBean(java.lang.Object, java.lang.String). However, InstantiationAwareBeanPostProcessor callbacks are applied, if applicable to the configuration of the instance.

Specified by:

autowireBeanProperties in interface AutowireCapableBeanFactory

Parameters:

existingBean - the existing bean instance

autowireMode - by name or type, using the constants in this interface

dependencyCheck - whether to perform a dependency check for object references in the bean instance

See Also:

AutowireCapableBeanFactory.AUTOWIRE_BY_NAME, AutowireCapableBeanFactory.AUTOWIRE_BY_TYPE, AutowireCapableBeanFactory.AUTOWIRE_NO

configureBean

public java.lang.Object configureBean(java.lang.Object existingBean,
                                      java.lang.String beanName)

Description copied from interface: AutowireCapableBeanFactory

Configure the given raw bean: autowiring bean properties, applying bean property values, applying factory callbacks such as setBeanName and setBeanFactory, and also applying all bean post processors (including ones which might wrap the given raw bean).

This is effectively a superset of what AutowireCapableBeanFactory.initializeBean(java.lang.Object, java.lang.String) provides, fully applying the configuration specified by the corresponding bean definition. Note: This method requires a bean definition for the given name!

Specified by:

configureBean in interface AutowireCapableBeanFactory

Parameters:

existingBean - the existing bean instance

beanName - the name of the bean, to be passed to it if necessary (a bean definition of that name has to be available)

Returns:

the bean instance to use, either the original or a wrapped one

See Also:

AutowireCapableBeanFactory.initializeBean(java.lang.Object, java.lang.String)

resolveNamedBean

public <T> NamedBeanHolder<T> resolveNamedBean(java.lang.Class<T> requiredType)
                                        throws BeansException

Description copied from interface: AutowireCapableBeanFactory

Resolve the bean instance that uniquely matches the given object type, if any, including its bean name.

This is effectively a variant of BeanFactory.getBean(Class) which preserves the bean name of the matching instance.

Specified by:

resolveNamedBean in interface AutowireCapableBeanFactory

Parameters:

requiredType - type the bean must match; can be an interface or superclass. null is disallowed.

Returns:

the bean name plus bean instance

Throws:

NoSuchBeanDefinitionException - if no matching bean was found

NoUniqueBeanDefinitionException - if more than one matching bean was found

BeansException - if the bean could not be created

See Also:

BeanFactory.getBean(Class)

resolveDependency

public java.lang.Object resolveDependency(DependencyDescriptor descriptor,
                                          java.lang.String requestingBeanName)

Description copied from interface: AutowireCapableBeanFactory

Resolve the specified dependency against the beans defined in this factory.

Specified by:

resolveDependency in interface AutowireCapableBeanFactory

Parameters:

descriptor - the descriptor for the dependency (field/method/constructor)

requestingBeanName - the name of the bean which declares the given dependency

Returns:

the resolved object, or null if none found

See Also:

AutowireCapableBeanFactory.resolveDependency(DependencyDescriptor, String, Set, TypeConverter)

resolveDependency

public java.lang.Object resolveDependency(DependencyDescriptor descriptor,
                                          java.lang.String requestingBeanName,
                                          java.util.Set<java.lang.String> autowiredBeanNames,
                                          TypeConverter typeConverter)

Description copied from interface: AutowireCapableBeanFactory

Resolve the specified dependency against the beans defined in this factory.

Specified by:

resolveDependency in interface AutowireCapableBeanFactory

Parameters:

descriptor - the descriptor for the dependency (field/method/constructor)

requestingBeanName - the name of the bean which declares the given dependency

autowiredBeanNames - a Set that all names of autowired beans (used for resolving the given dependency) are supposed to be added to

typeConverter - the TypeConverter to use for populating arrays and collections

Returns:

the resolved object, or null if none found

See Also:

DependencyDescriptor

applyBeanPropertyValues

public void applyBeanPropertyValues(java.lang.Object existingBean,
                                    java.lang.String beanName)
                             throws BeansException

Description copied from interface: AutowireCapableBeanFactory

Apply the property values of the bean definition with the given name to the given bean instance. The bean definition can either define a fully self-contained bean, reusing its property values, or just property values meant to be used for existing bean instances.

This method does not autowire bean properties; it just applies explicitly defined property values. Use the AutowireCapableBeanFactory.autowireBeanProperties(java.lang.Object, int, boolean) method to autowire an existing bean instance. Note: This method requires a bean definition for the given name!

Does not apply standard BeanPostProcessors callbacks or perform any further initialization of the bean. This interface offers distinct, fine-grained operations for those purposes, for example AutowireCapableBeanFactory.initializeBean(java.lang.Object, java.lang.String). However, InstantiationAwareBeanPostProcessor callbacks are applied, if applicable to the configuration of the instance.

Specified by:

applyBeanPropertyValues in interface AutowireCapableBeanFactory

Parameters:

existingBean - the existing bean instance

beanName - the name of the bean definition in the bean factory (a bean definition of that name has to be available)

Throws:

NoSuchBeanDefinitionException - if there is no bean definition with the given name

BeansException - if applying the property values failed

See Also:

AutowireCapableBeanFactory.autowireBeanProperties(java.lang.Object, int, boolean)

applyBeanPostProcessorsBeforeInitialization

public java.lang.Object applyBeanPostProcessorsBeforeInitialization(java.lang.Object existingBean,
                                                                    java.lang.String beanName)

Description copied from interface: AutowireCapableBeanFactory

Apply BeanPostProcessors to the given existing bean instance, invoking their postProcessBeforeInitialization methods. The returned bean instance may be a wrapper around the original.

Specified by:

applyBeanPostProcessorsBeforeInitialization in interface AutowireCapableBeanFactory

Parameters:

existingBean - the new bean instance

beanName - the name of the bean

Returns:

the bean instance to use, either the original or a wrapped one

See Also:

BeanPostProcessor.postProcessBeforeInitialization(java.lang.Object, java.lang.String)

applyBeanPostProcessorsAfterInitialization

public java.lang.Object applyBeanPostProcessorsAfterInitialization(java.lang.Object existingBean,
                                                                   java.lang.String beanName)

Description copied from interface: AutowireCapableBeanFactory

Apply BeanPostProcessors to the given existing bean instance, invoking their postProcessAfterInitialization methods. The returned bean instance may be a wrapper around the original.

Specified by:

applyBeanPostProcessorsAfterInitialization in interface AutowireCapableBeanFactory

Parameters:

existingBean - the new bean instance

beanName - the name of the bean

Returns:

the bean instance to use, either the original or a wrapped one

See Also:

BeanPostProcessor.postProcessAfterInitialization(java.lang.Object, java.lang.String)

destroyBean

public void destroyBean(java.lang.Object existingBean)

Description copied from interface: AutowireCapableBeanFactory

Destroy the given bean instance (typically coming from AutowireCapableBeanFactory.createBean(java.lang.Class<T>)), applying the DisposableBean contract as well as registered DestructionAwareBeanPostProcessors.

Any exception that arises during destruction should be caught and logged instead of propagated to the caller of this method.

Specified by:

destroyBean in interface AutowireCapableBeanFactory

Parameters:

existingBean - the bean instance to destroy