Spring源码系列：BeanDefinition源码解析

Bean的定义主要由BeanDefinition来描述的。做为Spring中用于包装Bean的数据结构，今天就来看看它的面纱下的真容吧。

首先就是BeanDefinition的类定义：

public interface BeanDefinition extends AttributeAccessor, BeanMetadataElement 复制代码

对，没错，这货是个接口，而不是类，是否是有点莫名奇妙呢？咱们都知道在JAVA中，接口是不能用来new出新的对象的，那么在Spring中，到底将XML解析出来的Bean包装成了什么呢？（这个密等下揭开）

先来看看BeanDefinition一个继承结构吧（均是与BeanDefinition有直接关联的类或者接口）！

从类图中能够看出，BeanDefinition继承了AttributeAccessor和BeanMetadataElement两个接口；一个一个看。

AttributeAccessor

AttributeAccessor接口定义了最基本的对任意对象的元数据的修改或者获取，主要方法有：

//将name定义的属性设置为提供的value值。若是value的值为null，则该属性为{@link #removeAttribute removed}。
//一般，用户应该注意经过使用彻底限定的名称（可能使用类或包名称做为前缀）来防止与其余元数据属性重叠。
void setAttribute(String name, Object value);
//获取标识为name的属性的值。
Object getAttribute(String name);
//删除标识为name的属性，并返回属性值
Object removeAttribute(String name);
//若是名为name的属性是否存在，存在返回true，不然返回false。
boolean hasAttribute(String name);
//返回全部属性的名称。
String[] attributeNames();
复制代码

BeanMetadataElement

BeanMetadataElement接口提供了一个getResource()方法,用来传输一个可配置的源对象。

//返回此元数据元素的配置源对象（可能为null）。
Object getSource();
复制代码

BeanDifinition源码分析

一个BeanDefinition描述了一个bean的实例，包括属性值，构造方法参数值和继承自它的类的更多信息。BeanDefinition仅仅是一个最简单的接口，主要功能是容许BeanFactoryPostProcessor 例如PropertyPlaceHolderConfigure 可以检索并修改属性值和别的bean的元数据（译注）。

//标准单例做用域的做用域标识符：“singleton”。
//对于扩展的bean工厂可能支持更多的做用域。
String SCOPE_SINGLETON = ConfigurableBeanFactory.SCOPE_SINGLETON;
复制代码

//标准原型做用域的范围标识符：“prototype”。
//对于扩展的bean工厂可能支持更多的做用域。
String SCOPE_PROTOTYPE = ConfigurableBeanFactory.SCOPE_PROTOTYPE;
复制代码

//表示BeanDefinition是应用程序主要部分的角色提示。 一般对应于用户定义的bean。
int ROLE_APPLICATION = 0;
复制代码

ROLE_SUPPORT =1实际上就是说，我这个Bean是用户的，是从配置文件中过来的。

//表示BeanDefinition是某些大型配置的支持部分的角色提示，一般是一个外部ComponentDefinition。
//当查看某个特定的ComponentDefinition时，认为bean很是重要，
//以便在查看应用程序的总体配置时可以意识到这一点。
int ROLE_SUPPORT = 1;
复制代码

ROLE_INFRASTRUCTURE = 2就是我这Bean是Spring本身的，和你用户没有一毛钱关系。

//角色提示代表一个BeanDefinition是提供一个彻底背景的角色，而且与最终用户没有关系。
//这个提示用于注册彻底是ComponentDefinition内部工做的一部分的bean
int ROLE_INFRASTRUCTURE = 2;
复制代码

上面是BeanDifinition的一些基本属性信息，一个就是标识下当前Bean的做用域，另外就是标识一下这个Bean是内部的仍是外部的。下面来看这个接口为其子类都提供了哪些具体的行为方法：

1.当前Bean父类名称get&set方法

//若是父类存在，设置这个bean定义的父定义的名称。
void setParentName(String parentName);
//若是父类存在，则返回当前Bean的父类的名称
String getParentName();
复制代码

2.当前Bean的className get&set方法

//指定此bean定义的bean类名称。
//类名称能够在bean factory后期处理中修改，一般用它的解析变体替换原来的类名称。
void setBeanClassName(String beanClassName);

//返回此bean定义的当前bean类名称。
//须要注意的是，这不必定是在运行时使用的实际类名，以防子类定义覆盖/继承其父类的类名。
//此外，这可能只是调用工厂方法的类，或者它 在调用方法的工厂bean引用的状况下甚至多是空的。
//所以，不要认为这是在运行时定义的bean类型，而只是将其用于在单独的bean定义级别进行解析。
String getBeanClassName();
复制代码

3.Bean的做用域get&set方法

//覆盖此bean的目标范围，指定一个新的范围名称。
void setScope(String scope);
//返回此bean的当前目标做用域的名称，若是没有肯定，返回null
String getScope();
复制代码

4.懒加载的get&set方法

//设置这个bean是否应该被延迟初始化。若是{false}，那么这个bean将在启动时由bean工厂实例化，
//这些工厂执行单例的当即初始化。
//懒加载 <bean lazy-init="true/false">
void setLazyInit(boolean lazyInit);
//返回这个bean是否应该被延迟初始化，即不是在启动时当即实例化。只适用于单例bean。
boolean isLazyInit();
复制代码

5.依赖关系设置

//设置这个bean依赖被初始化的bean的名字。 bean工厂将保证这些bean首先被初始化。
//<bean depends-on="">
void setDependsOn(String... dependsOn);
//返回这个bean依赖的bean名称。
String[] getDependsOn();
复制代码

6.是不是自动转配设置

//设置这个bean是不是得到自动装配到其余bean的候选人。
//须要注意是，此标志旨在仅影响基于类型的自动装配。
//它不会影响按名称的显式引用，即便指定的bean没有标记为autowire候选，也能够解决这个问题。
//所以，若是名称匹配，经过名称的自动装配将注入一个bean。
void setAutowireCandidate(boolean autowireCandidate);

//返回这个bean是不是自动装配到其余bean的候选者。就是是否在其余类中使用autowired来注入当前Bean的
//是否为被自动装配 <bean autowire-candidate="true/false">
boolean isAutowireCandidate();
复制代码

7.主候选Bean

//是否为主候选bean 使用注解：@Primary
void setPrimary(boolean primary);
//返回这个bean是不是主要的autowire候选者。
boolean isPrimary();
复制代码

8.定义建立该Bean对象的工厂类

//指定要使用的工厂bean（若是有的话）。 这是调用指定的工厂方法的bean的名称。
void setFactoryBeanName(String factoryBeanName);
//返回工厂bean的名字，若是有的话。
String getFactoryBeanName();
复制代码

9.建立该Bean对象的工厂方法

//若是有的话，指定工厂方法。
//这个方法先将经过构造函数参数被调用，或者若是参数，将调用该方法的无参数构造。
//方法将在指定的工厂bean（若是有的话）上被调用，或者做为本地bean类的静态方法被调用。
void setFactoryMethodName(String factoryMethodName);
//若是存在，返回工厂方法名
String getFactoryMethodName();
复制代码

10.返回此bean的构造函数参数值。

//返回此bean的构造函数参数值。
ConstructorArgumentValues getConstructorArgumentValues();
复制代码

11.获取普通属性集合

//获取普通属性集合
MutablePropertyValues getPropertyValues();
复制代码

12.当前Bean的基本特性

//是不是单例的
boolean isSingleton();
//是不是多例的
boolean isPrototype();
//是不是抽象类
boolean isAbstract();
复制代码

13.当前Bean的应用

//获取这个bean的应用
int getRole();
复制代码

13.可读描述

//返回对bean定义的可读描述。
String getDescription();
复制代码

//返回该bean定义来自的资源的描述
String getResourceDescription();
复制代码

//返回原始的BeanDefinition;若是没有，则返回null。容许检索装饰的bean定义（若是有的话）。
//注意，这个方法返回直接的发起者。 迭代原始链，找到用户定义的原始BeanDefinition。
BeanDefinition getOriginatingBeanDefinition();
复制代码

从上面的属性和方法分析能够看出，BeanDefinition对于一个Bean的描述作了较为完整的一套约束。这为后续的子类提供的最基本的职责和属性。

欢迎关注glmapper工做室公众号