Class ContextSingletonBeanFactoryLocator
- java.lang.Object
- org.springframework.beans.factory.access.SingletonBeanFactoryLocator
- org.springframework.context.access.ContextSingletonBeanFactoryLocator
- All Implemented Interfaces:
BeanFactoryLocator
public class ContextSingletonBeanFactoryLocator extends SingletonBeanFactoryLocator
Variant of
SingletonBeanFactoryLocator
which creates its internal bean factory reference as anApplicationContext
instead of SingletonBeanFactoryLocator's simple BeanFactory. For almost all usage scenarios, this will not make a difference, since within that ApplicationContext or BeanFactory you are still free to define either BeanFactory or ApplicationContext instances. The main reason one would need to use this class is if bean post-processing (or other ApplicationContext specific features are needed in the bean reference definition itself).Note: This class uses classpath*:beanRefContext.xml as the default resource location for the bean factory reference definition files. It is not possible nor legal to share definitions with SingletonBeanFactoryLocator at the same time.
- Author:
- Colin Sampaleanu, Juergen Hoeller
- See Also:
SingletonBeanFactoryLocator
,DefaultLocatorFactory
Field Summary
Fields inherited from class org.springframework.beans.factory.access.SingletonBeanFactoryLocator
logger
Constructor Summary
Constructors Modifier Constructor Description protected
ContextSingletonBeanFactoryLocator(String resourceLocation)
Constructor which uses the specified name as the resource name of the definition file(s).
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description protected BeanFactory
createDefinition(String resourceLocation, String factoryKey)
Overrides the default method to create definition object as an ApplicationContext instead of the default BeanFactory.protected void
destroyDefinition(BeanFactory groupDef, String selector)
Overrides the default method to operate on an ApplicationContext, invokingConfigurableApplicationContext.close()
.static BeanFactoryLocator
getInstance()
Returns an instance which uses the default "classpath*:beanRefContext.xml", as the name of the definition file(s).static BeanFactoryLocator
getInstance(String selector)
Returns an instance which uses the specified selector, as the name of the definition file(s).protected void
initializeDefinition(BeanFactory groupDef)
Overrides the default method to refresh the ApplicationContext, invokingConfigurableApplicationContext.refresh()
.Methods inherited from class org.springframework.beans.factory.access.SingletonBeanFactoryLocator
useBeanFactory
Constructor Detail
ContextSingletonBeanFactoryLocator
protected ContextSingletonBeanFactoryLocator(String resourceLocation)
Constructor which uses the specified name as the resource name of the definition file(s).- Parameters:
resourceLocation
- the Spring resource location to use (either a URL or a "classpath:" / "classpath*:" pseudo URL)
Method Detail
getInstance
public static BeanFactoryLocator getInstance() throws BeansException
Returns an instance which uses the default "classpath*:beanRefContext.xml", as the name of the definition file(s). All resources returned by the current thread's context class loader'sgetResources
method with this name will be combined to create a definition, which is just a BeanFactory.- Returns:
- the corresponding BeanFactoryLocator instance
- Throws:
BeansException
- in case of factory loading failure
getInstance
public static BeanFactoryLocator getInstance(String selector) throws BeansException
Returns an instance which uses the specified selector, as the name of the definition file(s). In the case of a name with a Spring "classpath*:" prefix, or with no prefix, which is treated the same, the current thread's context class loader'sgetResources
method will be called with this value to get all resources having that name. These resources will then be combined to form a definition. In the case where the name uses a Spring "classpath:" prefix, or a standard URL prefix, then only one resource file will be loaded as the definition.- Parameters:
selector
- the location of the resource(s) which will be read and combined to form the definition for the BeanFactoryLocator instance. Any such files must form a valid ApplicationContext definition.- Returns:
- the corresponding BeanFactoryLocator instance
- Throws:
BeansException
- in case of factory loading failure
createDefinition
protected BeanFactory createDefinition(String resourceLocation, String factoryKey)
Overrides the default method to create definition object as an ApplicationContext instead of the default BeanFactory. This does not affect what can actually be loaded by that definition.The default implementation simply builds a
ClassPathXmlApplicationContext
.- Overrides:
createDefinition
in classSingletonBeanFactoryLocator
- Parameters:
resourceLocation
- the resource location for this factory groupfactoryKey
- the bean name of the factory to obtain- Returns:
- the corresponding BeanFactory reference
initializeDefinition
protected void initializeDefinition(BeanFactory groupDef)
Overrides the default method to refresh the ApplicationContext, invokingConfigurableApplicationContext.refresh()
.- Overrides:
initializeDefinition
in classSingletonBeanFactoryLocator
- Parameters:
groupDef
- the factory returned bycreateDefinition()
destroyDefinition
protected void destroyDefinition(BeanFactory groupDef, String selector)
Overrides the default method to operate on an ApplicationContext, invokingConfigurableApplicationContext.close()
.- Overrides:
destroyDefinition
in classSingletonBeanFactoryLocator
- Parameters:
groupDef
- the factory returned bycreateDefinition()
selector
- the resource location for this factory group