spring beans源码解读之 ioc容器之始祖--DefaultListableBeanFactory

spring Ioc容器的实现，从根源上是beanfactory，但真正能够做为一个能够独立使用的ioc容器仍是DefaultListableBeanFactory，所以能够这么说，

DefaultListableBeanFactory 是整个spring ioc的始祖，研究透它的前生今世对咱们理解spring ioc的概念有着重要的做用。

1. DefaultListableBeanFactory的做用：

默认实现了ListableBeanFactory和BeanDefinitionRegistry接口，基于bean definition对象，是一个成熟的bean factroy。

最典型的应用是：在访问bean前，先注册全部的definition（可能从bean definition配置文件中）。使用预先创建的bean定义元数据对象，从本地的bean definition表中查询bean definition于是将不会花费太多成本。

DefaultListableBeanFactory既能够做为一个单独的beanFactory，也能够做为自定义beanFactory的父类。

注意：特定格式bean definition的解析器能够本身实现，也可使用原有的解析器，如：

PropertiesBeanDefinitionReader和XmLBeanDefinitionReader。

2. DefaultListableBeanFactory的继承关系

       (图片来源：http://www.myexception.cn/software-architecture-design/925888.html)

3. 好了，开始进入DefaultListableBeanFactory的大千世界

   直接继承关系：

public class DefaultListableBeanFactory extends AbstractAutowireCapableBeanFactory
        implements ConfigurableListableBeanFactory, BeanDefinitionRegistry, Serializable {
}

   3.1 静态方法

    private static Class<?> javaxInjectProviderClass = null;

    static {
        try {
            javaxInjectProviderClass =
                    ClassUtils.forName("javax.inject.Provider", DefaultListableBeanFactory.class.getClassLoader());
        }
        catch (ClassNotFoundException ex) {
            // JSR-330 API not available - Provider interface simply not supported then.
        }
    }

spring提供一些实用的综合工具类如ClassUtils，ClassUtils提供了对类的实用方法，主要用在框架内部，想要了解更全面的类的工具方法能够参考apache commons lang。

Commons Lang
The standard Java libraries fail to provide enough methods for manipulation of its core classes. Apache Commons Lang provides these extra methods.

Lang provides a host of helper utilities for the java.lang API, notably String manipulation methods, basic numerical methods, object reflection, concurrency, creation and serialization and System properties. Additionally it contains basic enhancements to java.util.Date and a series of utilities dedicated to help with building methods, such as hashCode, toString and equals

ClassUtils.forName方法是class.forname的重写，返回一个类的实例，区别请参考源码。

上述静态方法中返回了javax.inject.Provider的一个实例，那么咱们揭开javax.inject.Provider的面纱看看它到底起了什么做用。

语法：public interface Provider<T>

提供了一个 T的实例. 一般做为一个依赖注入容器器的父接口. 能够注入任何类型的 T, 固然也能够注入 Provider<T>. 相对于直接注入 T,注入 Provider<T>有以下做用:

• 检索多个实例.
• 延迟或者选择性的检索一个实例.
• 打破循环依赖.
• 抽象的scope，能够从一个包含scope的更小的scope中检索一个实例。

实例代码：

   class Car {
     @Inject Car(Provider<Seat> seatProvider) {
       Seat driver = seatProvider.get();
       Seat passenger = seatProvider.get();
       ...
     }
   }

3.2 继承自AbstractAutowireCapableBeanFactory的方法：

AbstractAutowireCapableBeanFactory的做用：

提供bean的建立 (有construct方法), 属性注值, 绑定 (包括自动绑定)和初始化.

处理运行时bean引用, 解析管理的集合, 调用初始化方法。

最主要的子类要实现的模板方法是 AutowireCapableBeanFactory.resolveDependency(DependencyDescriptor, String, Set, TypeConverter), 这个方法用来实现类型的自动绑定.

在DefaultListableBeanFactory中实现了AbstractAutowireCapableBeanFactory.copyConfigurationFrom

    @Override
    public void copyConfigurationFrom(ConfigurableBeanFactory otherFactory) {
        super.copyConfigurationFrom(otherFactory);
        if (otherFactory instanceof DefaultListableBeanFactory) {
            DefaultListableBeanFactory otherListableFactory = (DefaultListableBeanFactory) otherFactory;
            this.allowBeanDefinitionOverriding = otherListableFactory.allowBeanDefinitionOverriding;
            this.allowEagerClassLoading = otherListableFactory.allowEagerClassLoading;
            this.autowireCandidateResolver = otherListableFactory.autowireCandidateResolver;
            this.resolvableDependencies.putAll(otherListableFactory.resolvableDependencies);
        }
    }

其中：

allowBeanDefinitionOverriding定义了是否容许同名的不一样bean definition再次进行注册；

allowEagerClassLoading 定义了是否容许eager类（相对于lazy）的加载，甚至延迟初始化的bean的加载。

autowireCandidateResolver是一个策略接口，用来决定一个特定的bean definition 是否知足作一个特定依赖的自动绑定的候选项，方法以下所示：

//SimpleAutowireCandidateResolver implements AutowireCandidateResolver

@Override 

public boolean isAutowireCandidate(BeanDefinitionHolder bdHolder, DependencyDescriptor descriptor) { 
 return bdHolder.getBeanDefinition().isAutowireCandidate(); }

//GenericTypeAwareAutowireCandidateResolver implements AutowireCandidateResolver

@Override 
public boolean isAutowireCandidate(BeanDefinitionHolder bdHolder, DependencyDescriptor descriptor) {

        if (!bdHolder.getBeanDefinition().isAutowireCandidate()) {
            // if explicitly false, do not proceed with any other checks
            return false;
        }
        return (descriptor == null || checkGenericTypeMatch(bdHolder, descriptor));
    }

resolvableDependencies:定义了依赖类型和其对应的自动绑定值的键值对集合。

AbstractAutowireCapableBeanFactory的copyConfigurationFrom方法：

    @Override
    public void copyConfigurationFrom(ConfigurableBeanFactory otherFactory) {
        super.copyConfigurationFrom(otherFactory);
        if (otherFactory instanceof AbstractAutowireCapableBeanFactory) {
            AbstractAutowireCapableBeanFactory otherAutowireFactory =
                    (AbstractAutowireCapableBeanFactory) otherFactory;
            this.instantiationStrategy = otherAutowireFactory.instantiationStrategy;
            this.allowCircularReferences = otherAutowireFactory.allowCircularReferences;
            this.ignoredDependencyTypes.addAll(otherAutowireFactory.ignoredDependencyTypes);
            this.ignoredDependencyInterfaces.addAll(otherAutowireFactory.ignoredDependencyInterfaces);
        }
    }

其中，instantiationStrategy 为建立bean 实例的策略，默认值：

private InstantiationStrategy instantiationStrategy = new CglibSubclassingInstantiationStrategy();

allowCircularReferences 肯定是否自动尝试去解析循环引用的bean。

ignoredDependencyTypes 定义了在依赖检查和自动绑定时要忽略的依赖类型，是一组类对象，例如string，默认为没有。

ignoredDependencyInterfaces  定义了在依赖检查和自动绑定时要忽略的依赖接口，是一组类对象，默认状况下，只有beanFactory接口被忽略。

父类AbstractBeanFactory的copyConfigurationFrom的实现以下：

    @Override
    public void copyConfigurationFrom(ConfigurableBeanFactory otherFactory) {
        Assert.notNull(otherFactory, "BeanFactory must not be null");
        setBeanClassLoader(otherFactory.getBeanClassLoader());
        setCacheBeanMetadata(otherFactory.isCacheBeanMetadata());
        setBeanExpressionResolver(otherFactory.getBeanExpressionResolver());
        if (otherFactory instanceof AbstractBeanFactory) {
            AbstractBeanFactory otherAbstractFactory = (AbstractBeanFactory) otherFactory;
            this.customEditors.putAll(otherAbstractFactory.customEditors);
            this.propertyEditorRegistrars.addAll(otherAbstractFactory.propertyEditorRegistrars);
            this.beanPostProcessors.addAll(otherAbstractFactory.beanPostProcessors);
            this.hasInstantiationAwareBeanPostProcessors = this.hasInstantiationAwareBeanPostProcessors ||
                    otherAbstractFactory.hasInstantiationAwareBeanPostProcessors;
            this.hasDestructionAwareBeanPostProcessors = this.hasDestructionAwareBeanPostProcessors ||
                    otherAbstractFactory.hasDestructionAwareBeanPostProcessors;
            this.scopes.putAll(otherAbstractFactory.scopes);
            this.securityContextProvider = otherAbstractFactory.securityContextProvider;
        }
        else {
            setTypeConverter(otherFactory.getTypeConverter());
        }
    }

其中

customEditors 是自定义的属性编辑器，适用于该beanFactory的全部bean。
propertyEditorRegistrars属性编辑器的注册器，使用于该beanFactory的全部bean。

beanPostProcessors 建立bean时应用的beanPostProcessors。

hasInstantiationAwareBeanPostProcessors 代表是否注册有任何的InstantiationAwareBeanPostProcessors。
hasDestructionAwareBeanPostProcessors代表是否注册有任何的DestructionAwareBeanPostProcessors

scopes：域标识符和对应域的键值对集合。

securityContextProvider 运行SecurityManager时使用的security context。

3.3 继承自ListableBeanFactory接口的方法

ListableBeanFactory是beanFactory接口的扩展接口，它能够枚举全部的bean实例，而不是客户端经过名称一个一个的查询得出全部的实例。要预加载全部的bean定义的beanfactory能够实现这个接口来。该 接口定义了访问容器中Bean基本信息的若干方法，如查看Bean的个数、获取某一类型Bean的配置名、查看容器中是否包括某一Bean等方法；

containsBeanDefinition(String beanName) 
Check if this bean factory contains a bean definition with the given name. 

findAnnotationOnBean(String beanName, Class<A> annotationType) 
Find a Annotation of annotationType on the specified bean, traversing its interfaces and super classes if no annotation can be found on the given class itself. 

getBeanDefinitionCount() 
Return the number of beans defined in the factory. 

getBeanDefinitionNames() 
Return the names of all beans defined in this factory. 

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. 

getBeanNamesForType(Class<?> type, boolean includeNonSingletons, boolean allowEagerInit) 
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. 

getBeansOfType(Class<T> 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. 

getBeansOfType(Class<T> type, boolean includeNonSingletons, boolean allowEagerInit) 
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. 

getBeansWithAnnotation(Class<? extends Annotation> annotationType) 
Find all beans whose Class has the supplied Annotation type.

3.4 继承自ConfigurableListableBeanFactory接口的方法
ConfigurableListableBeanFactory 它同时继承了ListableBeanFactory，AutowireCapableBeanFactory和ConfigurableBeanFactory，提供了对bean定义的分析和修改的便利方法，同时也提供了对单例的预实例化。

void freezeConfiguration() 
Freeze all bean definitions, signalling that the registered bean definitions will not be modified or post-processed any further. 

BeanDefinition getBeanDefinition(String beanName) 
Return the registered BeanDefinition for the specified bean, allowing access to its property values and constructor argument value (which can be modified during bean factory post-processing). 

void ignoreDependencyInterface(Class<?> ifc) 
Ignore the given dependency interface for autowiring. 

void ignoreDependencyType(Class<?> type) 
Ignore the given dependency type for autowiring: for example, String. 

boolean isAutowireCandidate(String beanName, DependencyDescriptor descriptor) 
Determine whether the specified bean qualifies as an autowire candidate, to be injected into other beans which declare a dependency of matching type. 

boolean isConfigurationFrozen() 
Return whether this factory's bean definitions are frozen, i.e. 

void preInstantiateSingletons() 
Ensure that all non-lazy-init singletons are instantiated, also considering FactoryBeans. 

void registerResolvableDependency(Class<?> dependencyType, Object autowiredValue) 
Register a special dependency type with corresponding autowired value. 

3.5 继承自BeanDefinitionRegistry接口的方法
BeanDefinitionRegistry：Spring配置文件中每个<bean>节点元素在Spring容器里都经过一个BeanDefinition对象表示，它描述了Bean的配置信息。而BeanDefinition Registry接口提供了向容器手工注册BeanDefinition对象的方法。

boolean containsBeanDefinition(String beanName) 
Check if this registry contains a bean definition with the given name. 

BeanDefinition getBeanDefinition(String beanName) 
Return the BeanDefinition for the given bean name. 

int getBeanDefinitionCount() 
Return the number of beans defined in the registry. 

String[] getBeanDefinitionNames() 
Return the names of all beans defined in this registry. 

boolean isBeanNameInUse(String beanName) 
Determine whether the given bean name is already in use within this registry, i.e. 

void registerBeanDefinition(String beanName, BeanDefinition beanDefinition) 
Register a new bean definition with this registry. 

void removeBeanDefinition(String beanName) 
Remove the BeanDefinition for the given name. 

3.6 序列化支持

 private void writeObject(java.io.ObjectOutputStream out)throws IOException
 private void readObject(java.io.ObjectInputStream in)throws IOException, ClassNotFoundException;
 private void readObjectNoData()throws ObjectStreamException;

4 小结：

spring Ioc容器的实现，从根源上是beanfactory，但真正能够做为一个能够独立使用的ioc容器仍是DefaultListableBeanFactory，所以能够这么说，

DefaultListableBeanFactory 是整个spring ioc的始祖，研究透它的前生今世对咱们理解spring ioc的概念有着重要的做用。

DefaultListableBeanFactory功能的实现是经过实现特定功能的接口来完成。

AbstractAutowireCapableBeanFactory 实现属性的自动绑定功能。

ConfigurableListableBeanFactory提供了对bean定义的分析和修改的便利方法，同时也提供了对单例的预实例化。

  ListableBeanFactory提供枚举全部的bean实例，而不是客户端经过名称一个一个的查询得出全部的实例。

BeanDefinitionRegistry 提供了beanDefinition的管理。