Spring的bean定义 1 : 基础建模--接口BeanDefinition

Spring Bean定义详解

最新推荐文章于 2025-10-17 20:51:39 发布

原创最新推荐文章于 2025-10-17 20:51:39 发布 · 2k 阅读

8 ·

CC 4.0 BY-SA版权

spring 同时被 2 个专栏收录

115 篇文章

订阅专栏

Spring Core

56 篇文章

订阅专栏

本文深入解析Spring框架中BeanDefinition的概念，介绍了BeanDefinition如何描述bean的创建信息，包括属性、构造函数参数、作用域等。同时，阐述了BeanDefinition的几种实现类：RootBeanDefinition、ChildBeanDefinition和GenericBeanDefinition的特点及适用场景。

简介

对于基于Spring框架开发的一个应用系统，其中每一个bean都来自于一个bean定义:开发人员的某个bean定义,框架自身的某个bean定义，三方库的某个bean定义。这些概念上的bean定义，通过Spring接口BeanDefinition被建模，并且在应用运行时都会以一个BeanDefinition对象的形式被注册到Spring IoC容器中。所以说,bean定义,或者说,BeanDefinition接口，是整个Spring容器的根本概念之一。

一个BeanDefinition描述和定义了创建一个bean需要的所有信息，属性，构造函数参数以及访问它们的方法。还有其他一些信息，比如这些定义来源自哪个类等等。

接口`BeanDefinition` 简介

Spring框架中的接口BeanDefinition顾名思义，就是"bean定义"的意思，它定义了创建相应的bean 使用如下属性 :

属性名称	介绍
`parentName`	双亲`bean`定义(`parent bean definition`)的名称.如果没有双亲bean定义,这里为空
`beanClassName`	`bean`的类名，在`bean factory`的`post process`阶段可能会被修改。注意该属性并不总是运行时被对应`bean`真正使用的类的名称：比如，`bean`是通过某个类的静态工厂方法生成的，这里是该类的类名，再比如，`bean`是通过一个工厂`bean`生成的，那这里为空。
`scope`	作用域, `singleton`或者`prototype`。在`bean`的作用域尚未决定之前，该属性为`null`
`lazyInit`	是否懒加载，仅适用于`singleton bean`。当一个`singleton bean`被指定`lazyInit`为`false`时,它会在`bean factory`启动时执行`singleton bean`初始化的阶段被实例化。
`dependsOn`	所依赖的`bean`的名称，如果有多个依赖的`bean`,这里需要都列出来。容器会保证这些被依赖的`bean`先被初始化。
`autowireCandidate`	该`bean`是否作为自动绑定的候选,仅适用于基于类型的自动绑定。基于名称的绑定不受此属性影响。
`primary`	当前`bean`定义是否主`bean`。当某个自动绑定遇到多个候选`bean`时,`primary`属性为`true`的会被使用。
`factoryBeanName`	如果要使用`factory bean`来创建`bean`,这里指定了相应的工厂`bean`的类名称
`factoryMethodName`	工厂方法名称。基于类静态工厂方法的情况下，结合`beanClassName`使用;基于工厂`bean`的情况下，结合`factoryBeanName`使用。如果`bean`定义的`constructorArgumentValues`有内容，工厂方法被调用时会使用该属性。
`constructorArgumentValues`	`bean`创建时的构造函数参数
`propertyValues`	新建的`bean`需要设置的属性值
`initMethodName`	`bean`的初始化方法
`destroyMethodName`	`bean`的析构方法
`role`	`bean`的角色:`APPLICATION`,`SUPPORT`,`INFRASTRUCTURE`。提示框架该`bean`的角色和重要程度。
`description`	`bean`的描述，`human readable`
`singleton`	作用域断言，是否`singleton`
`prototype`	作用域断言，是否`prototype`
`abstract`	是否抽象`bean`定义,抽象`bean`定义的目的不是用于实例化`bean`,而是有其他目的。
`resourceDescription`	资源描述文本，告知当前`bean`定义的来源，一般用于错误时显示上下文。
`originatingBeanDefinition`	返回来源`bean`定义(如果有的话)。通过该属性，可以获取被修饰的`bean`定义。需要注意的是该属性仅仅返回`直接`来源`bean`定义而不是返回`最深处`的来源`bean`定义。一个`bean`定义的`originatingBeanDefinition`属性隐含了一个来源`bean`定义链，通过迭代访问该链，可以最终找到最终来自用户的`bean`定义。

上表中提到的bean的角色，分别是:

APPLICATION – 指出该bean是应用程序的主要部分，通常对应用户定义的bean。
SUPPORT – 应用支持性质的bean,在某些地方比较重要，但从整个应用的返回来看，还没那么重要。
INFRASTRUCTURE – 基础设施bean,仅仅用于框架内部工作，跟终端用户无关。

除了上述直接通过BeanDefinition自身进行的定义，,接口BeanDefinition还继承了另外两个接口 : AttributeAccessor和BeanMetadataElement。

AttributeAccessor接口定义了对一个bean属性的访问 :

方法	介绍
`setAttribute`	设置指定的属性为特定值
`getAttribute`	获取指定的属性的值
`removeAttribute`	删除指定的属性
`hasAttribute`	是否拥有指定的属性
`attributeNames`	获取所有属性的名称

BeanMetadataElement接口定义了一个bean定义的配置来源:

方法	介绍
`getSource`	获取当前元数据元素的配置来源类

接口`BeanDefinition` 实现类简介

BeanDefinition 接口有一些实现类，并且这些实现类有一些共同的基础逻辑。这些实现类主要是 : RootBeanDefinition,ChildBeanDefinition和GenericBeanDefinition。它们共同的基础逻辑实现在抽象类AbstractBeanDefinition。这些类之间的层级关系如下:
在这里插入图片描述

各个接口`BeanDefinition` 实现类使用注意事项

一般建议

一般情况下，建议使用GenericBeanDefinition用于定义用户可见的bean定义。而对于一些父子关系已经确定的情况，使用RootBeanDefinition/ChildBeanDefinition。

各个实现类的区别/特点

RootBeanDefinition– 不能设置parent bean定义

由此可见,RootBeanDefinition不能用于用于父子bean定义关系中的"子bean定义"

ChildBeanDefinition – 必须设置parent bean定义,而且必须是通过构造函数指定

ChildBeanDefinition很适合父子bean定义关系明确的情况下基于双亲bean定义和自身少量设置一些个性化属性从而进行子bean定义。
实际上，真正在创建子bean定义规定的bean对象时，Spring框架内部是将双亲bean定义和孩子bean定义合并形成一个最终使用的RootBeanDefinition，这里孩子bean定义中设置的属性会被优先使用，没有指定的都会继承使用双亲bean定义中的设置。