1 缘起
作为一个应用开发人员而言，会使用某一个工具分为两个层次（个人观点）：
第一个层次，知道工具，会使用这个工具解决问题；
第二个层次，理解工具的实现原理。
关于Spring的学习，还在第一个层次转悠，缺少原理的研究，
随着学习的深入，开始研究些Spring源码，配合IDEA调试，
逐渐理解一些Spring原理，先从创建Bean开始，
分享如下。
2 新建Bean
对于Spring学习、使用和研究人员而言，
Bean必修课，Bean从何而来，又如何获取，
弄清楚这些，会加深对Spring的理解。
首先从创建Bean开始，常见的创建方式有3种：
- 注解@Bean方式
- Xml方式
- BeanDefinitionBuilder方式
Spring提供了多种方式创建Bean，这里的创建Bean是创建自定义的Bean，
不涉及Spring启动时需要创建的系统Bean，
但是殊途同归，最终都是通过BeanDefinition构建Bean，
创建自定义的Bean会经历两个核心步骤：
- 注册BeanDefinition
填充beanDefinitionMap和beanDefiinitionNames，为填充singletonObjects准备 - 创建单例Bean
填充singletonObjects，供后续获取Bean使用
2.1 @Bean方式
通过@Bean方式创建自定义Bean是最明显的方式，
直接在对应的方法上添加@Bean注解，表明这是Bean，
结合@Configuration，Spring会自动创建Bean，
测试样例及注释如下：
package com.monkey.springboottemplate.modules.bean_definition;
import com.monkey.springboottemplate.common.entity.UserEntity;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* 注解新建Bean.
*
* @author xindaqi
* @since 2022-12-14 16:01
*/
@Configuration
public class BeanDefinitionByAnnotation {
private static final Logger logger = LoggerFactory.getLogger(BeanDefinitionByAnnotation.class);
@Bean
public UserEntity myUserBean() {
return new UserEntity("xiaohua", "欧洲");
}
public static void main(String[] args) {
AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext();
// 注册BeanDefinition
applicationContext.register(BeanDefinitionByAnnotation.class);
// 加载或刷新配置（Java基础配置/XML/properties等）的持久化描述，
// 这里关注填充singletonObjects
applicationContext.refresh();
logger.info(">>>>>>>>>>应用程序上下文启动");
UserEntity user = applicationContext.getBean(UserEntity.class);
logger.info(">>>>>>>>Bean:{}", user);
applicationContext.close();
logger.info(">>>>>>>>关闭应用程序上下文");
}
}
2.2 XML方式
通过XML创建Bean，首先要构建对应的XML文件，
配置样例及注释如下：
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
<!-- 在Spring framework中启用@Resource注解 -->
<context:annotation-config />
<!-- 构建User Bean实例：Bean id为user1 -->
<bean id="userA" class="com.monkey.springboottemplate.common.entity.UserEntity">
<property name="nickname" value="xiaoxml" />
<property name="address" value="欧洲" />
</bean>
</beans>
XML文件只是存储Bean的持久化配置文件，
想要使该Bean加载到Spring容器，仍需要通过相关类加载该XML文件，
测试样例以及注释如下：
package com.monkey.springboottemplate.modules.bean_definition;
import com.monkey.springboottemplate.common.entity.UserEntity;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
/**
* XML新建Bean.
*
* @author xindaqi
* @since 2022-12-14 15:59
*/
public class BeanDefinitionByXml {
private static final Logger logger = LoggerFactory.getLogger(BeanDefinitionByXml.class);
public static void main(String[] args) {
String beanConfig = "bean-creation.xml";
// 通过XML配置文件构建Bean
ApplicationContext applicationContext = new ClassPathXmlApplicationContext(beanConfig);
UserEntity user = applicationContext.getBean("userA", UserEntity.class);
logger.info(">>>>>>>>Creation Bean using XML, User Bean :{}", user);
}
}
2.3 BeanDefinition
上面两种创建Bean的方式对于应用开发者而言是显式的，
而，更贴近Spring底层的方式是通过BeanDefinition创建Bean，
Spring创建Bean的第一个过程即注册BeanDefinition，就是下面的样例，
通过显式的方式注册BeanDefinition，
然后再创建单例的Bean，测试样例及注释如下：
package com.monkey.springboottemplate.modules.bean_definition;
import com.monkey.springboottemplate.common.entity.UserEntity;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.BeansException;
import org.springframework.beans.factory.config.BeanPostProcessor;
import org.springframework.beans.factory.support.AbstractBeanDefinition;
import org.springframework.beans.factory.support.BeanDefinitionBuilder;
import org.springframework.beans.factory.support.DefaultListableBeanFactory;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
/**
* BeanDefinition新建Bean.
*
* @author xindaqi
* @since 2022-12-14 16:01
*/
public class BeanDefinitionByBuilder {
private static final Logger logger = LoggerFactory.getLogger(BeanDefinitionByBuilder.class);
public static void main(String[] args) {
AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext();
// 构建BeanDefinition，填充Bean属性
BeanDefinitionBuilder beanDefinitionBuilder = BeanDefinitionBuilder.genericBeanDefinition(UserEntity.class);
beanDefinitionBuilder.addPropertyValue("nickname", "xiaoxiao");
AbstractBeanDefinition beanDefinition = beanDefinitionBuilder.getBeanDefinition();
// 注册BeanDefinition
applicationContext.registerBeanDefinition("myBean", beanDefinition);
// 加载或刷新配置（Java基础配置/XML/properties等）的持久化描述，
// 这里关注填充singletonObjects
applicationContext.refresh();
logger.info(">>>>>>>>>>应用程序上下文启动");
UserEntity user1 = applicationContext.getBean(UserEntity.class);
UserEntity user2 = (UserEntity) applicationContext.getBean("myBean");
logger.info(">>>>>>>>>>User:{}, user2:{}", user1, user2);
applicationContext.close();
logger.info(">>>>>>>>关闭应用程序上下文");
}
}
3 源码分析
3.1 创建Bean流程
Spring中创建自定义Bean的核心流程如下图所示，
由图可知，创建自定义Bean分成两个部分：
- 注册BeanDefition
- 注册Bean
核心都是填充对应的数据结构，
最终把Bean添加到Spring构建的Bean容器中，供后续取用。
虽然干巴巴流程太流于表面，没有质感，但是，这些使用源码中抠出来的
虽然散，但是，易于理解和记忆，
后面会详细给出流程的源码及源码分析。
3.2 BeanDefinition相关
先从注册BeanDefinition开始分析，
BeanDefiniton，从命名即可知，是Bean的定义，用于描述Bean，
Spring将BeanDefinition设计为一个interface，面向接口，
BeanDefinition源码长这样，如下图所示，
这里仅需要知道BeanDefinition是用于描述Bean的即可，
会在其他文章详细讲解BeanDefinition。
为什么要注册BeanDefinition？
因为BeanDefinition用于描述Bean实例，因此，创建Bean的时候需要先注册BeanDefition，描述Bean，然后再创建Bean，两者是关联的。
注册BeanDefinition的核心是填充beanDefinitionMap和beanDefinitionNames。
-
beanDefinitionMap
位置：org.springframework.beans.factory.support.DefaultListableBeanFactory#beanDefinitionMap
源码如下图所示，由注释可知，beanDefinitionMap用于存储bean名称和beanDefintion，所谓的关联关系就在这里，(key, value)->(beanName, beanDefinition)，为后续通过beanName获取beanDefinition做准备。
-
beanDefinitionNames
位置：org.springframework.beans.factory.support.DefaultListableBeanFactory#beanDefinitionNames
源码如下图所示，由注释可知，beanDefintionNames存储Bean名称，为后续填充singletonObjects做准备。
3.2.1 流程
前置知识已介绍，下面进入正题，讲解流程。
源码调试流程如下图所示，感兴趣的可以参照流程图中打断点调试。
(1)AnnotationConfigApplicationContext中注册BeanDefinition：registerBeanDefinition
(2)GenericApplicationContext中注册BeanDefinition：registerBeanDefinition
(3)DefaultListableBeanFactory中注册BeanDefinition：registerBeanDefinition
(4)DefaultListableBeanFactory中填充beanDefinitionMap：beanDefinitionMap.put
(5)DefaultListableBeanFactory中填充beanDefinitionNames：beanDefinitionNames.add
3.2.2 源码调试过程
3.2.2.1 AnnotationConfigApplicationContext中注册BeanDefinition：registerBeanDefinition
3.2.2.2 GenericApplicationContext中注册BeanDefinition：registerBeanDefinition
3.2.2.3 DefaultListableBeanFactory中注册BeanDefinition：registerBeanDefinition
3.2.2.4 DefaultListableBeanFactory中填充beanDefinitionMap：beanDefinitionMap.put &
3.2.2.5 DefaultListableBeanFactory中填充beanDefinitionNames：beanDefinitionNames.add
合并步骤4和5，填充对应的数据。
3.3 Bean相关
完成上面的准备工作，接下来就要创建Bean，
这个Bean实际单例对象，在singletonObjects中存储，为后面获取Bean做准备。
singletonObjects：
位置：org.springframework.beans.factory.support.DefaultSingletonBeanRegistry#singletonObjects
源码如下图所示，由注释可知，singletonObjects缓存单例Bean实例。
3.3.1 流程
下面开始讲解如何填充这个Map，
源码调试流程如下图所示，感兴趣的可以参照流程图中打断点调试。
(1)AnnotationConfigApplicationContext中刷新相关的Bean：refresh
(2)同步锁，AbstractApplicationContext中刷新相关Bean：refresh
(3)结束BeanFactory初始化，AbstractApplicationContext初始化的最后一步，完成准备工作之后，需要固化相关的操作：finishBeanFactoryInitialization
(4)预处理，DefaultListableBeanFactory实例化单体Bean：preInstantiateSingletons
(5)获取Bean，AbstractBeanFactory根据Bean名称获取Bean：getBean(java.lang.String)
(6)获取Bean，AbstractBeanFactory获取Bean：doGetBean
(7)获取单例Bean，DefaultSingletonBeanRegistry根据Bean名称获取单例Bean：getSingleton(java.lang.String, org.springframework.beans.factory.ObjectFactory<?>)
(8)添加单例Bean，DefaultSingletonBeanRegistry添加单例Bean：addSingleton
(9)添加Bean，DefaultSingletonBeanRegistry：singletonObjects.put
3.3.2 源码调试过程
3.3.2.1 AnnotationConfigApplicationContext中刷新相关的Bean：refresh
3.3.2.2 同步锁，AbstractApplicationContext中刷新相关Bean：refresh
3.3.2.3 结束BeanFactory初始化，AbstractApplicationContext初始化的最后一步，完成准备工作之后，需要固化相关的操作：finishBeanFactoryInitialization
3.3.2.4 预处理，DefaultListableBeanFactory实例化单体Bean：preInstantiateSingletons
3.3.2.5 获取Bean，AbstractBeanFactory根据Bean名称获取Bean：getBean(java.lang.String)
3.3.2.6 获取Bean，AbstractBeanFactory获取Bean：doGetBean
3.3.2.7 获取单例Bean，DefaultSingletonBeanRegistry根据Bean名称获取单例Bean：getSingleton(java.lang.String, org.springframework.beans.factory.ObjectFactory<?>)
3.3.2.8 添加单例Bean，DefaultSingletonBeanRegistry添加单例Bean：addSingleton
3.3.2.9 添加Bean，DefaultSingletonBeanRegistry：singletonObjects.put
3.4 获取Bean
通过上面的准备工作，填充了相关的数据，
下面可以通过应用上下文获取Bean。
3.4.1 流程
源码调试流程如下图所示，感兴趣的可以参照流程图中打断点调试。
(1)获取Bean，AnnotationConfigApplicationContext：getBean
(2)获取Bean，AbstractApplicationContext：getBean(java.lang.String)
(3)获取Bean，AbstractBeanFactory：getBean(java.lang.String)
(4)处理逻辑，获取Bean，AbstractBeanFactory：doGetBean
(5)从填充的singletonObjects获取Bean，DefaultSingletonBeanRegistry：getSingleton(java.lang.String)
(6)获取Bean，得到查询的Bean，DefaultSingletonBeanRegistry：getSingleton(java.lang.String, boolean)
3.4.2 源码调试
3.4.2.1 获取Bean，AnnotationConfigApplicationContext：getBean
3.4.2.2 获取Bean，AbstractApplicationContext：getBean(java.lang.String)
3.4.2.3 获取Bean，AbstractBeanFactory：getBean(java.lang.String)
3.4.2.4 处理逻辑，获取Bean，AbstractBeanFactory：doGetBean
3.4.2.5 从填充的singletonObjects获取Bean，DefaultSingletonBeanRegistry：getSingleton(java.lang.String)
3.4.2.6 获取Bean，得到查询的Bean，DefaultSingletonBeanRegistry：getSingleton(java.lang.String, boolean)
最终返回查到的Bean。
4 小结
（1）新建Bean的三种方式：XML、@Bean和BeanDefinition；
（2）创建Bean的核心过程：
（2.1）注册BeanDefinition，填充beanDefinitionMap和beanDefinitionNames；
（2.2）注册Bean，填充singletonObjects；
（3）通过应用上下文获取Bean，是通过singletonObjects查询获取。