|
|||||||||||
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 List |
doGetBeanNamesForType(Class type,
boolean includePrototypes,
boolean includeFactoryBeans)
Get a List of all bean names that match the given type (including subclasses), judging from either bean definitions or the value of getObjectType
in the case of FactoryBeans. |
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. |
String[] |
getBeanNamesForType(Class type)
Return the names of beans matching the given type (including subclasses), judging from either bean definitions or the value of getObjectType
in the case of FactoryBeans.
|
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 beanName,
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 java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface org.springframework.beans.factory.config.ConfigurableListableBeanFactory |
ignoreDependencyType |
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, containsSingleton, destroySingletons, 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 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)
,
ListableBeanFactory.containsBeanDefinition(java.lang.String)
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
Does not consider objects created by FactoryBeans but rather the
FactoryBean classes themselves, avoiding instantiation of any beans. Use
getBeanNamesForType
to match objects created by FactoryBeans.
Does not consider any hierarchy this factory may participate in.
Use BeanFactoryUtils' beanNamesIncludingAncestors
to include beans in ancestor factories too.
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
ListableBeanFactory.getBeanNamesForType(java.lang.Class)
,
BeanFactoryUtils.beanNamesIncludingAncestors(ListableBeanFactory, Class)
public String[] getBeanNamesForType(Class type)
ListableBeanFactory
getObjectType
in the case of FactoryBeans.
Does consider objects created by FactoryBeans but rather the FactoryBean classes themselves, which means that FactoryBeans will get instantiated.
Does not consider any hierarchy this factory may participate in.
Use BeanFactoryUtils' beanNamesForTypeIncludingAncestors
to include beans in ancestor factories too.
Note: Does not ignore singleton beans that have been registered by other means than bean definitions.
getBeanNamesForType
in interface ListableBeanFactory
type
- the class or interface to match, or null for all bean names
FactoryBean.getObjectType()
,
BeanFactoryUtils.beanNamesForTypeIncludingAncestors(ListableBeanFactory, Class)
public Map getBeansOfType(Class type) throws BeansException
ListableBeanFactory
getObjectType
in the case of FactoryBeans.
Does consider objects created by FactoryBeans but rather the FactoryBean classes themselves, which means that FactoryBeans will get instantiated.
Does not consider any hierarchy this factory may participate in.
Use BeanFactoryUtils' beansOfTypeIncludingAncestors
to include beans in ancestor factories too.
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 a bean could not be createdFactoryBean.getObjectType()
,
BeanFactoryUtils.beansOfTypeIncludingAncestors(ListableBeanFactory, Class)
public Map getBeansOfType(Class type, boolean includePrototypes, boolean includeFactoryBeans) throws BeansException
ListableBeanFactory
getObjectType
in the case of FactoryBeans.
Does consider objects created by FactoryBeans but rather the FactoryBean classes themselves, which means that FactoryBeans will get instantiated.
Does not consider any hierarchy this factory may participate in.
Use BeanFactoryUtils' beansOfTypeIncludingAncestors
to include beans in ancestor factories too.
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 a bean could not be createdFactoryBean.getObjectType()
,
BeanFactoryUtils.beansOfTypeIncludingAncestors(ListableBeanFactory, Class, boolean, boolean)
protected List doGetBeanNamesForType(Class type, boolean includePrototypes, boolean includeFactoryBeans)
getObjectType
in the case of FactoryBeans.
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
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 beanName, BeanDefinition beanDefinition) throws BeanDefinitionStoreException
BeanDefinitionRegistry
registerBeanDefinition
in interface BeanDefinitionRegistry
beanName
- 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
,
ConfigurableListableBeanFactory.getBeanDefinition(java.lang.String)
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 |