org.springframework.beans.factory.support
Class AbstractBeanFactory

Direct Known Subclasses:

DefaultListableBeanFactory

public abstract class AbstractBeanFactory

implements AutowireCapableBeanFactory, ConfigurableBeanFactory

Abstract superclass that makes implementing a BeanFactory very easy.

This class uses the Template Method design pattern. Subclasses must implement only the getBeanDefinition(name) method.

This class handles resolution of runtime bean references, FactoryBean dereferencing, and management of collection properties. It also allows for management of a bean factory hierarchy, implementing the HierarchicalBeanFactory interface.

Supports "inner bean definitions": Singleton flags and names of such "inner beans" are always ignored: Inner beans are anonymous prototypes.

Author:

Rod Johnson, Juergen Hoeller

Version: $Id: AbstractBeanFactory.java,v 1.46 2004/02/11 10:50:06 jhoeller Exp $

Since: 15 April 2001

public final static String FACTORY_BEAN_PREFIX

Used to dereference a FactoryBean and distinguish it from beans created by the factory. For example, if the bean named myEjb is a factory, getting &myEjb will return the factory, not the instance returned by the factory.

public AbstractBeanFactory()

Create a new AbstractBeanFactory.

public AbstractBeanFactory(BeanFactory parentBeanFactory)

Create a new AbstractBeanFactory with the given parent.

Parameters:

parentBeanFactory - parent bean factory, or null if none

See Also:

getBean(java.lang.String)

public void addBeanPostProcessor(BeanPostProcessor beanPostProcessor)

public Object applyBeanPostProcessorsAfterInitialization(Object bean, String name)
                                                   throws org.springframework.beans.BeansException

public Object applyBeanPostProcessorsBeforeInitialization(Object bean, String name)
                                                    throws org.springframework.beans.BeansException

public Object autowire(Class beanClass, int autowireMode, boolean dependencyCheck)
                 throws org.springframework.beans.BeansException

public void autowireBeanProperties(Object existingBean, int autowireMode, boolean dependencyCheck)
                             throws org.springframework.beans.BeansException

public boolean containsBean(String name)

public void destroySingletons()

public String[] getAliases(String name)
                     throws org.springframework.beans.factory.NoSuchBeanDefinitionException

public Object getBean(String name)
                throws org.springframework.beans.BeansException

Return the bean with the given name, checking the parent bean factory if not found.

Parameters:

name - name of the bean to retrieve

public Object getBean(String name, Class requiredType)
                throws org.springframework.beans.BeansException

public abstract AbstractBeanDefinition getBeanDefinition(String beanName)
                                                   throws org.springframework.beans.BeansException

Return the bean definition for the given bean name. Subclasses should normally implement caching, as this method is invoked by this class every time a bean is requested.

Parameters:

beanName - name of the bean to find a definition for

Returns: the BeanDefinition for this prototype name. Must never return null.

Throws:

NoSuchBeanDefinitionException - if the bean definition cannot be resolved

BeansException - in case of errors

public List getBeanPostProcessors()

Return the list of BeanPostProcessors that will get applied to beans created with this factory.

public ConstructorArgumentValues getConstructorArgumentValues(String beanName)
                                                        throws org.springframework.beans.BeansException

public Map getCustomEditors()

Return the map of custom editors, with Classes as keys and PropertyEditors as values.

public Set getIgnoredDependencyTypes()

Return the set of classes that will get ignored for autowiring.

public RootBeanDefinition getMergedBeanDefinition(String beanName, boolean includingAncestors)
                                            throws org.springframework.beans.BeansException

Return a RootBeanDefinition, even by traversing parent if the parameter is a child definition. Will ask the parent bean factory if not found in this instance.

Returns: a merged RootBeanDefinition with overridden properties

public BeanFactory getParentBeanFactory()

public MutablePropertyValues getPropertyValues(String beanName)
                                         throws org.springframework.beans.BeansException

public String[] getSingletonNames(Class type)

Return the names of beans in the singleton cache that match the given object type (including subclasses). Will not consider FactoryBeans as the type of their created objects is not known before instantiation.

Does not consider any hierarchy this factory may participate in.

Parameters:

type - class or interface to match, or null for all bean names

Returns: the names of beans in the singleton cache that match the given object type (including subclasses), or an empty array if none

public void ignoreDependencyType(Class type)

public boolean isSingleton(String name)
                     throws org.springframework.beans.factory.NoSuchBeanDefinitionException

public void registerAlias(String beanName, String alias)
                    throws org.springframework.beans.factory.BeanDefinitionStoreException

public void registerCustomEditor(Class requiredType, PropertyEditor propertyEditor)

public void registerSingleton(String beanName, Object singletonObject)
                        throws org.springframework.beans.factory.BeanDefinitionStoreException

public void setParentBeanFactory(BeanFactory parentBeanFactory)

Association Links

to Class java.lang.String

Used to dereference a FactoryBean and distinguish it from beans created by the factory. For example, if the bean named myEjb is a factory, getting &myEjb will return the factory, not the instance returned by the factory.

to Class org.springframework.beans.factory.BeanFactory

Parent bean factory, for bean inheritance support

to Class java.util.Map

to Class java.util.List

BeanPostProcessors to apply on createBean

to Class java.util.Set

Dependency types to ignore on dependency check and autowire

to Class java.util.Map

Cache of singletons: bean name --> bean instance

to Class java.util.Map

Map from alias to canonical bean name