|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.springframework.beans.factory.support.AbstractBeanFactory org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory org.springframework.beans.factory.support.DefaultListableBeanFactory
Default implementation of the ListableBeanFactory and BeanDefinitionRegistry interfaces: a full-fledged bean factory based on bean definitions.
Typical usage is registering all bean definitions first (possibly read from a bean definition file), before accessing beans. Bean definition lookup is therefore an inexpensive operation in a local bean definition table.
Can be used as a standalone bean factory, or as a superclass for custom bean factories. Note that readers for specific bean definition formats are typically implemented separately rather than as bean factory subclasses.
For an alternative implementation of the ListableBeanFactory interface, have a look at StaticListableBeanFactory, which manages existing bean instances rather than creating new ones based on bean definitions.
ListableBeanFactory
,
StaticListableBeanFactory
,
PropertiesBeanDefinitionReader
,
XmlBeanDefinitionReader
Field Summary |
Fields inherited from class org.springframework.beans.factory.support.AbstractBeanFactory |
logger |
Fields inherited from interface org.springframework.beans.factory.BeanFactory |
FACTORY_BEAN_PREFIX |
Fields inherited from interface org.springframework.beans.factory.config.AutowireCapableBeanFactory |
AUTOWIRE_AUTODETECT, AUTOWIRE_BY_NAME, AUTOWIRE_BY_TYPE, AUTOWIRE_CONSTRUCTOR |
Constructor Summary | |
DefaultListableBeanFactory()
Create a new DefaultListableBeanFactory. |
|
DefaultListableBeanFactory(BeanFactory parentBeanFactory)
Create a new DefaultListableBeanFactory with the given parent. |
Method Summary | |
boolean |
containsBeanDefinition(String beanName)
Check if this registry contains a bean definition with the given name. |
protected Map |
findMatchingBeans(Class requiredType)
Find bean instances that match the required type. |
BeanDefinition |
getBeanDefinition(String beanName)
Return the registered BeanDefinition for the given bean, allowing access to its property values and constructor argument value (which can be modified during bean factory post-processing). |
int |
getBeanDefinitionCount()
Return the number of beans defined in the registry. |
String[] |
getBeanDefinitionNames()
Return the names of all beans defined in this registry. |
String[] |
getBeanDefinitionNames(Class type)
Return the names of beans matching the given type (including subclasses), judging from the bean definitions. |
Map |
getBeansOfType(Class type)
Return the bean instances that match the given object type (including subclasses), judging from either bean definitions or the value of getObjectType() in the case of FactoryBeans. |
Map |
getBeansOfType(Class type,
boolean includePrototypes,
boolean includeFactoryBeans)
Return the bean instances that match the given object type (including subclasses), judging from either bean definitions or the value of getObjectType() in the case of FactoryBeans. |
void |
preInstantiateSingletons()
Ensure that all non-lazy-init singletons are instantiated, also considering FactoryBeans. |
void |
registerBeanDefinition(String name,
BeanDefinition beanDefinition)
Register a new bean definition with this registry. |
void |
setAllowBeanDefinitionOverriding(boolean allowBeanDefinitionOverriding)
Set if it should be allowed to override bean definitions by registering a different definition with the same name, automatically replacing the former. |
String |
toString()
|
Methods inherited from class org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory |
applyBeanPostProcessorsAfterInitialization, applyBeanPostProcessorsBeforeInitialization, applyBeanPropertyValues, autowire, autowireBeanProperties, autowireByName, autowireByType, autowireConstructor, createBean, createBean, dependencyCheck, instantiateUsingFactoryMethod, invokeCustomInitMethod, invokeInitMethods, populateBean, resolveValueIfNecessary, setInstantiationStrategy, unsatisfiedObjectProperties |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface org.springframework.beans.factory.BeanFactory |
containsBean, getAliases, getBean, getBean, getType, isSingleton |
Methods inherited from interface org.springframework.beans.factory.config.AutowireCapableBeanFactory |
applyBeanPostProcessorsAfterInitialization, applyBeanPostProcessorsBeforeInitialization, applyBeanPropertyValues, autowire, autowireBeanProperties |
Methods inherited from interface org.springframework.beans.factory.config.ConfigurableBeanFactory |
addBeanPostProcessor, destroySingletons, ignoreDependencyType, registerAlias, registerCustomEditor, registerSingleton, setParentBeanFactory |
Methods inherited from interface org.springframework.beans.factory.HierarchicalBeanFactory |
getParentBeanFactory |
Methods inherited from interface org.springframework.beans.factory.support.BeanDefinitionRegistry |
getAliases, registerAlias |
Constructor Detail |
public DefaultListableBeanFactory()
public DefaultListableBeanFactory(BeanFactory parentBeanFactory)
Method Detail |
public void setAllowBeanDefinitionOverriding(boolean allowBeanDefinitionOverriding)
public int getBeanDefinitionCount()
BeanDefinitionRegistry
getBeanDefinitionCount
in interface ListableBeanFactory
BeanFactoryUtils.countBeansIncludingAncestors(org.springframework.beans.factory.ListableBeanFactory)
public String[] getBeanDefinitionNames()
BeanDefinitionRegistry
getBeanDefinitionNames
in interface ListableBeanFactory
BeanFactoryUtils.beanNamesIncludingAncestors(ListableBeanFactory)
public String[] getBeanDefinitionNames(Class type)
ListableBeanFactory
Note: Ignores any singleton beans that have been registered by other means than bean definitions.
getBeanDefinitionNames
in interface ListableBeanFactory
type
- the class or interface to match, or null for all bean names
BeanFactoryUtils.beanNamesIncludingAncestors(ListableBeanFactory, Class)
public boolean containsBeanDefinition(String beanName)
BeanDefinitionRegistry
containsBeanDefinition
in interface ListableBeanFactory
containsBeanDefinition
in class AbstractBeanFactory
beanName
- the name of the bean to look for
AbstractBeanFactory.containsBean(java.lang.String)
public Map getBeansOfType(Class type) throws BeansException
ListableBeanFactory
If FactoryBean's getObjectType() returns null and the bean is a singleton, the type of the actually created objects should be evaluated. Prototypes without explicit object type specification should be ignored.
Note: Does not ignore singleton beans that have been registered by other means than bean definitions.
This version of getBeansOfType matches all kinds of beans, be it
singletons, prototypes, or FactoryBeans. In most implementations, the
result will be the same as for getBeansOfType(type, true, true)
.
getBeansOfType
in interface ListableBeanFactory
type
- the class or interface to match, or null for all concrete beans
BeansException
- if the beans could not be createdFactoryBean.getObjectType()
,
BeanFactoryUtils.beansOfTypeIncludingAncestors(ListableBeanFactory, Class)
public Map getBeansOfType(Class type, boolean includePrototypes, boolean includeFactoryBeans) throws BeansException
ListableBeanFactory
If FactoryBean's getObjectType() returns null and the bean is a singleton, the type of the actually created objects should be evaluated. Prototypes without explicit object type specification should be ignored.
Note: Does not ignore singleton beans that have been registered by other means than bean definitions.
getBeansOfType
in interface ListableBeanFactory
type
- the class or interface to match, or null for all concrete beansincludePrototypes
- whether to include prototype beans too
or just singletons (also applies to FactoryBeans)includeFactoryBeans
- whether to include FactoryBeans too
or just conventional beans
BeansException
- if the beans could not be createdFactoryBean.getObjectType()
,
BeanFactoryUtils.beansOfTypeIncludingAncestors(ListableBeanFactory, Class, boolean, boolean)
public void preInstantiateSingletons() throws BeansException
ConfigurableListableBeanFactory
As this is a startup method, it should destroy already created singletons if it fails, to avoid dangling resources. In other words, after invocation of that method, either all or no singletons at all should be instantiated.
preInstantiateSingletons
in interface ConfigurableListableBeanFactory
BeansException
- if one of the singleton beans could not be createdpublic void registerBeanDefinition(String name, BeanDefinition beanDefinition) throws BeanDefinitionStoreException
BeanDefinitionRegistry
registerBeanDefinition
in interface BeanDefinitionRegistry
name
- the name of the bean instance to registerbeanDefinition
- definition of the bean instance to register
BeanDefinitionStoreException
RootBeanDefinition
,
ChildBeanDefinition
public BeanDefinition getBeanDefinition(String beanName) throws BeansException
ConfigurableListableBeanFactory
A returned BeanDefinition object should not be a copy but the original definition object as registered in the factory. This means that it should be castable to a more specific implementation type, if necessary.
getBeanDefinition
in interface ConfigurableListableBeanFactory
getBeanDefinition
in class AbstractBeanFactory
beanName
- name of the bean to find a definition for
BeansException
- in case of errorsRootBeanDefinition
,
ChildBeanDefinition
protected Map findMatchingBeans(Class requiredType)
AbstractAutowireCapableBeanFactory
findMatchingBeans
in class AbstractAutowireCapableBeanFactory
requiredType
- the type of the beans to look up
AbstractAutowireCapableBeanFactory.autowireByType(java.lang.String, org.springframework.beans.factory.support.RootBeanDefinition, org.springframework.beans.BeanWrapper, org.springframework.beans.MutablePropertyValues)
,
AbstractAutowireCapableBeanFactory.autowireConstructor(java.lang.String, org.springframework.beans.factory.support.RootBeanDefinition)
public String toString()
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |