java.lang.Object | |
↳ | org.springframework.beans.factory.BeanFactoryUtils |
Convenience methods operating on bean factories, in particular
on the ListableBeanFactory
interface.
Returns bean counts, bean names or bean instances, taking into account the nesting hierarchy of a bean factory (which the methods defined on the ListableBeanFactory interface don't, in contrast to the methods defined on the BeanFactory interface).
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String | GENERATED_BEAN_NAME_SEPARATOR | Separator for generated bean names. |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Get all bean names for the given type, including those defined in ancestor
factories.
| |||||||||||
Get all bean names for the given type, including those defined in ancestor
factories.
| |||||||||||
Return all bean names in the factory, including ancestor factories.
| |||||||||||
Return a single bean of the given type or subtypes, not looking in ancestor
factories.
| |||||||||||
Return a single bean of the given type or subtypes, not looking in ancestor
factories.
| |||||||||||
Return a single bean of the given type or subtypes, also picking up beans
defined in ancestor bean factories if the current bean factory is a
HierarchicalBeanFactory.
| |||||||||||
Return a single bean of the given type or subtypes, also picking up beans
defined in ancestor bean factories if the current bean factory is a
HierarchicalBeanFactory.
| |||||||||||
Return all beans of the given type or subtypes, also picking up beans defined in
ancestor bean factories if the current bean factory is a HierarchicalBeanFactory.
| |||||||||||
Return all beans of the given type or subtypes, also picking up beans defined in
ancestor bean factories if the current bean factory is a HierarchicalBeanFactory.
| |||||||||||
Count all beans in any hierarchy in which this factory participates.
| |||||||||||
Return whether the given name is a factory dereference
(beginning with the factory dereference prefix).
| |||||||||||
Return whether the given name is a bean name which has been generated
by the default naming strategy (containing a "#..." part).
| |||||||||||
Extract the "raw" bean name from the given (potentially generated) bean name,
excluding any "#..." suffixes which might have been added for uniqueness.
| |||||||||||
Return the actual bean name, stripping out the factory dereference
prefix (if any, also stripping repeated factory prefixes if found).
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Separator for generated bean names. If a class name or parent name is not unique, "#1", "#2" etc will be appended, until the name becomes unique.
Get all bean names for the given type, including those defined in ancestor factories. Will return unique names in case of overridden bean definitions.
Does consider objects created by FactoryBeans if the "allowEagerInit" flag is set, which means that FactoryBeans will get initialized. If the object created by the FactoryBean doesn't match, the raw FactoryBean itself will be matched against the type. If "allowEagerInit" is not set, only raw FactoryBeans will be checked (which doesn't require initialization of each FactoryBean).
lbf | the bean factory |
---|---|
type | the type that beans must match |
includeNonSingletons | whether to include prototype or scoped beans too or just singletons (also applies to FactoryBeans) |
allowEagerInit | whether to initialize lazy-init singletons and objects created by FactoryBeans (or by factory methods with a "factory-bean" reference) for the type check. Note that FactoryBeans need to be eagerly initialized to determine their type: So be aware that passing in "true" for this flag will initialize FactoryBeans and "factory-bean" references. |
Get all bean names for the given type, including those defined in ancestor factories. Will return unique names in case of overridden bean definitions.
Does consider objects created by FactoryBeans, which means that FactoryBeans will get initialized. If the object created by the FactoryBean doesn't match, the raw FactoryBean itself will be matched against the type.
This version of beanNamesForTypeIncludingAncestors
automatically
includes prototypes and FactoryBeans.
lbf | the bean factory |
---|---|
type | the type that beans must match |
Return all bean names in the factory, including ancestor factories.
lbf | the bean factory |
---|
Return a single bean of the given type or subtypes, not looking in ancestor factories. Useful convenience method when we expect a single bean and don't care about the bean name.
Does consider objects created by FactoryBeans if the "allowEagerInit" flag is set, which means that FactoryBeans will get initialized. If the object created by the FactoryBean doesn't match, the raw FactoryBean itself will be matched against the type. If "allowEagerInit" is not set, only raw FactoryBeans will be checked (which doesn't require initialization of each FactoryBean).
lbf | the bean factory |
---|---|
type | type of bean to match |
includeNonSingletons | whether to include prototype or scoped beans too or just singletons (also applies to FactoryBeans) |
allowEagerInit | whether to initialize lazy-init singletons and objects created by FactoryBeans (or by factory methods with a "factory-bean" reference) for the type check. Note that FactoryBeans need to be eagerly initialized to determine their type: So be aware that passing in "true" for this flag will initialize FactoryBeans and "factory-bean" references. |
NoSuchBeanDefinitionException | if 0 or more than 1 beans of the given type were found |
---|---|
BeansException | if the bean could not be created |
Return a single bean of the given type or subtypes, not looking in ancestor factories. Useful convenience method when we expect a single bean and don't care about the bean name.
Does consider objects created by FactoryBeans, which means that FactoryBeans will get initialized. If the object created by the FactoryBean doesn't match, the raw FactoryBean itself will be matched against the type.
This version of beanOfType
automatically includes
prototypes and FactoryBeans.
lbf | the bean factory |
---|---|
type | type of bean to match |
NoSuchBeanDefinitionException | if 0 or more than 1 beans of the given type were found |
---|---|
BeansException | if the bean could not be created |
Return a single bean of the given type or subtypes, also picking up beans defined in ancestor bean factories if the current bean factory is a HierarchicalBeanFactory. Useful convenience method when we expect a single bean and don't care about the bean name.
Does consider objects created by FactoryBeans if the "allowEagerInit" flag is set, which means that FactoryBeans will get initialized. If the object created by the FactoryBean doesn't match, the raw FactoryBean itself will be matched against the type. If "allowEagerInit" is not set, only raw FactoryBeans will be checked (which doesn't require initialization of each FactoryBean).
Note: Beans of the same name will take precedence at the 'lowest' factory level, i.e. such beans will be returned from the lowest factory that they are being found in, hiding corresponding beans in ancestor factories. This feature allows for 'replacing' beans by explicitly choosing the same bean name in a child factory; the bean in the ancestor factory won't be visible then, not even for by-type lookups.
lbf | the bean factory |
---|---|
type | type of bean to match |
includeNonSingletons | whether to include prototype or scoped beans too or just singletons (also applies to FactoryBeans) |
allowEagerInit | whether to initialize lazy-init singletons and objects created by FactoryBeans (or by factory methods with a "factory-bean" reference) for the type check. Note that FactoryBeans need to be eagerly initialized to determine their type: So be aware that passing in "true" for this flag will initialize FactoryBeans and "factory-bean" references. |
NoSuchBeanDefinitionException | if 0 or more than 1 beans of the given type were found |
---|---|
BeansException | if the bean could not be created |
Return a single bean of the given type or subtypes, also picking up beans defined in ancestor bean factories if the current bean factory is a HierarchicalBeanFactory. Useful convenience method when we expect a single bean and don't care about the bean name.
Does consider objects created by FactoryBeans, which means that FactoryBeans will get initialized. If the object created by the FactoryBean doesn't match, the raw FactoryBean itself will be matched against the type.
This version of beanOfTypeIncludingAncestors
automatically includes
prototypes and FactoryBeans.
Note: Beans of the same name will take precedence at the 'lowest' factory level, i.e. such beans will be returned from the lowest factory that they are being found in, hiding corresponding beans in ancestor factories. This feature allows for 'replacing' beans by explicitly choosing the same bean name in a child factory; the bean in the ancestor factory won't be visible then, not even for by-type lookups.
lbf | the bean factory |
---|---|
type | type of bean to match |
NoSuchBeanDefinitionException | if 0 or more than 1 beans of the given type were found |
---|---|
BeansException | if the bean could not be created |
Return all beans of the given type or subtypes, also picking up beans defined in ancestor bean factories if the current bean factory is a HierarchicalBeanFactory. The returned Map will only contain beans of this type.
Does consider objects created by FactoryBeans if the "allowEagerInit" flag is set, which means that FactoryBeans will get initialized. If the object created by the FactoryBean doesn't match, the raw FactoryBean itself will be matched against the type. If "allowEagerInit" is not set, only raw FactoryBeans will be checked (which doesn't require initialization of each FactoryBean).
Note: Beans of the same name will take precedence at the 'lowest' factory level, i.e. such beans will be returned from the lowest factory that they are being found in, hiding corresponding beans in ancestor factories. This feature allows for 'replacing' beans by explicitly choosing the same bean name in a child factory; the bean in the ancestor factory won't be visible then, not even for by-type lookups.
lbf | the bean factory |
---|---|
type | type of bean to match |
includeNonSingletons | whether to include prototype or scoped beans too or just singletons (also applies to FactoryBeans) |
allowEagerInit | whether to initialize lazy-init singletons and objects created by FactoryBeans (or by factory methods with a "factory-bean" reference) for the type check. Note that FactoryBeans need to be eagerly initialized to determine their type: So be aware that passing in "true" for this flag will initialize FactoryBeans and "factory-bean" references. |
BeansException | if a bean could not be created |
---|
Return all beans of the given type or subtypes, also picking up beans defined in ancestor bean factories if the current bean factory is a HierarchicalBeanFactory. The returned Map will only contain beans of this type.
Does consider objects created by FactoryBeans, which means that FactoryBeans will get initialized. If the object created by the FactoryBean doesn't match, the raw FactoryBean itself will be matched against the type.
Note: Beans of the same name will take precedence at the 'lowest' factory level, i.e. such beans will be returned from the lowest factory that they are being found in, hiding corresponding beans in ancestor factories. This feature allows for 'replacing' beans by explicitly choosing the same bean name in a child factory; the bean in the ancestor factory won't be visible then, not even for by-type lookups.
lbf | the bean factory |
---|---|
type | type of bean to match |
BeansException | if a bean could not be created |
---|
Count all beans in any hierarchy in which this factory participates. Includes counts of ancestor bean factories.
Beans that are "overridden" (specified in a descendant factory with the same name) are only counted once.
lbf | the bean factory |
---|
Return whether the given name is a factory dereference (beginning with the factory dereference prefix).
name | the name of the bean |
---|
Return whether the given name is a bean name which has been generated by the default naming strategy (containing a "#..." part).
name | the name of the bean |
---|
Extract the "raw" bean name from the given (potentially generated) bean name, excluding any "#..." suffixes which might have been added for uniqueness.
name | the potentially generated bean name |
---|
Return the actual bean name, stripping out the factory dereference prefix (if any, also stripping repeated factory prefixes if found).
name | the name of the bean |
---|