手写Spring框架-壹

背景

最近工作比较轻松,于是趁着手里没有活,就打算自己写一个简单的Spring框架,因为之前背Spring的八股的时候老是背了就忘。
--本来前面写的好好的,也能勉强理解,但是到了第七章写应用上下文时,一下子来了十多个接口和抽象类,直接就蒙了,于是打算画图帮助理解,并且写博客记录,防止以后又忘了。。

参考

小傅哥:https://bugstack.cn/md/spring/develop-spring/2021-05-16-第1章:开篇介绍,手写Spring能给你带来什么?.html

因为前面第七章前面并不难,所以直接从第七章开始。
首先介绍一下Bean的生命周期:

1. 容器启动阶段

加载配置(XML、注解、JavaConfig)

解析成 BeanDefinition(class、scope、依赖等元信息)

注册到 BeanDefinitionRegistry

2. BeanFactoryPostProcessor 阶段

触发时机:在任何 Bean 实例化之前

作用:修改 BeanDefinition 的元信息

典型用途:占位符替换 ${}、动态修改属性值等

注意:此时 Bean 还没有被创建。

3. Bean 实例化阶段

Spring 调用构造方法 / 工厂方法,new 出对象。

此时只是一个“空壳对象”,还没有属性。

4. 属性填充(依赖注入)

Spring 根据 BeanDefinition 里的信息,进行 依赖注入:

XML 里 配置的属性注入

构造器 / Setter 注入

时机:实例化之后,初始化之前

5. BeanPostProcessor 前置处理

调用 postProcessBeforeInitialization(bean, beanName)

在 Bean 初始化方法之前执行

6. 初始化方法

如果实现了 InitializingBean,执行 afterPropertiesSet()

7. BeanPostProcessor 后置处理

调用 postProcessAfterInitialization(bean, beanName)

8. Bean 就绪

现在 Bean 已经完全可用了,交给容器管理。

正文

本章的目标是实现满足于在 Bean 对象从容器启动到Bean可用的过程中执行用户的自定义操作,但是如果只是添加这两个接口,不做任何包装,那么对于使用者来说还是非常麻烦的。我们希望于开发 Spring 的上下文操作类,把相应的 XML 加载 、注册、实例化以及新增的修改和扩展都融合进去,让 Spring 可以自动扫描到我们的新增服务,便于用户使用。
image

提供给用户的扩展接口

首先是BeanFactoryPostProcessor接口,该接口是spring提供给用户使用的接口,用户实现该接口就可以在Bean实例化之前使用BeanFactory对Bean的注册信息进行操作。
注意:此时 Bean 还没被创建。

public interface BeanFactoryPostProcessor {
    /**
     * 在所有的 BeanDefinition 加载完成后,实例化 Bean 对象之前,提供修改 BeanDefinition 属性的机制
     *
     * @param beanFactory
     * @throws BeansException
     */
    void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException;
}

然后是实现BeanPostProcessor接口,该接口是spring提供给用户使用的接口,用户通过实现该接口,就可以在Bean初始化前后对Bean进行操作。

public interface BeanPostProcessor {
    /**
     * 在 Bean 对象执行初始化方法之前,执行此方法
     *
     * @param bean
     * @param beanName
     * @return
     * @throws BeansException
     */
    Object postProcessBeforeInitialization(Object bean, String beanName) throws BeansException;

    /**
     * 在 Bean 对象执行初始化方法之后,执行此方法
     *
     * @param bean
     * @param beanName
     * @return
     * @throws BeansException
     */
    Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException;
}

Spring内部使用的接口

上面讲的是Spring提供给用户使用的接口,而spring内部也得有相关的定义,才能支持这种扩展

ListableBeanFactory接口

该接口的作用是可以获取IOC容器里的多个Bean,是对BeanFactory的扩展,BeanFactory一次只能获取一个Bean

public interface ListableBeanFactory extends BeanFactory{
    /**
     * 按照类型返回 Bean 实例
     * @param type
     * @param <T>
     * @return
     * @throws BeansException
     */
    <T> Map<String, T> getBeansOfType(Class<T> type) throws BeansException;

    /**
     * Return the names of all beans defined in this registry.
     *
     * 返回注册表中所有的Bean名称
     */
    String[] getBeanDefinitionNames();
}

HierarchicalBeanFactory接口

这是一个标记性接口,定义了spring容器分层的概念

public interface HierarchicalBeanFactory extends BeanFactory {
}

AutowireCapableBeanFactory接口

这个接口很容易与前面的BeanPostFactory接口混淆,这个接口是Spring内部使用的!!!
继承BeanFactory接口是需要获得getBean的能力,它本身提供了两个方法,用于在Bean初始化前后

public interface AutowireCapableBeanFactory extends BeanFactory {

    /**
     * 执行 BeanPostProcessors 接口实现类的 postProcessBeforeInitialization 方法
     * 在Bean初始化之前执行一些操作-BeforeInitialization
     *
     * @param existingBean
     * @param beanName
     * @return
     * @throws BeansException
     */
    Object applyBeanPostProcessorsBeforeInitialization(Object existingBean, String beanName) throws BeansException;

    /**
     * 执行 BeanPostProcessors 接口实现类的 postProcessorsAfterInitialization 方法
     * 在Bean初始化之后执行一些操作-AfterInitialization
     *
     * @param existingBean
     * @param beanName
     * @return
     * @throws BeansException
     */
    Object applyBeanPostProcessorsAfterInitialization(Object existingBean, String beanName) throws BeansException;
}

ConfigurableBeanFactory接口

继承HierarchicalBeanFactory代表支持容器分层的能力
继承SingletonBeanRegistry代表有获取单例Bean的能力
它的功能是在BeanFactory基础上,一个支持父子容器、单例缓存并且可以有生命周期扩展(BeanPostProcessor-Bean初始化前后扩展处理的能力)
并且具有保存和管理 BeanPostProcessor 列表的能力,定义了addBeanPostProcessor()方法

public interface ConfigurableBeanFactory extends HierarchicalBeanFactory, SingletonBeanRegistry {

    /**
     * 两种作用域
     */
    String SCOPE_SINGLETON = "singleton";

    String SCOPE_PROTOTYPE = "prototype";

    void addBeanPostProcessor(BeanPostProcessor beanPostProcessor);
}

ConfigurableListableBeanFactory接口

这个接口非常重要,它继承了ListableBeanFactory(支持一次获取多个Bean的能力)、AutowireCapableBeanFactory(支持自动注入能力-创建和装配Bean)、
ConfigurableBeanFactory(支持作用域、配置、Bean初始化前后扩展的能力)
这代表了这个接口能够完整实现IOC容器的所有职责,实现了它就代表了是一个完整Spring容器!!!

public interface ConfigurableListableBeanFactory extends ListableBeanFactory, AutowireCapableBeanFactory, ConfigurableBeanFactory {
    BeanDefinition getBeanDefinition(String beanName) throws BeansException;

    void preInstantiateSingletons() throws BeansException;
}

到了这里,Spring内部管理Bean实例的接口就创建好了,接下来创建上下文相关接口
ApplicationContext是对外的接口,给用户使用的,所以得继承ListableBeanFactory来获得对Bean的查询能力,方便用户获取Bean。
问题:为什么不继承其他继承了BeanFactory的接口,比如ConfigurableBeanFactory,它也有这些功能?
解答:还是上面那句话,ApplicationContext是给用户使用的,而ConfigurableBeanFactory是给容器内部使用的

ApplicationContext接口

public interface ApplicationContext extends ListableBeanFactory {
}

ConfigurableApplicationContext接口

refresh()是spring容器的核心启动方法
这也是给spring内部容器使用的,所以单独创建了它,而不是在ApplicationContext里定义refresh()方法

public interface ConfigurableApplicationContext extends ApplicationContext{

    /**
     * 刷新容器
     * @throws BeansException
     */
    void refresh() throws BeansException;
}

AbstractApplicationContext抽象类

该抽象类用模板方法模式实现了refresh()方法逻辑
并且继承了DefaultResourceLoader来获得加载资源的能力,因为refresh()需要解析xml文件加载Bean

public abstract class AbstractApplicationContext extends DefaultResourceLoader implements ConfigurableApplicationContext {
    @Override
    public void refresh() throws BeansException {
        // 1. 创建 BeanFactory,并加载 BeanDefinition
        refreshBeanFactory();

        // 2. 获取 BeanFactory
        ConfigurableListableBeanFactory beanFactory = getBeanFactory();

        // 3. 在 Bean 实例化之前,执行 BeanFactoryPostProcessor (Invoke factory processors registered as beans in the context.)
        // 真正执行了
        invokeBeanFactoryPostProcessors(beanFactory);

        // 4. BeanPostProcessor 需要提前于其他 Bean 对象实例化之前执行注册操作
        // 只是注册,加入到执行链中,并没有执行
        registerBeanPostProcessors(beanFactory);

        // 5. 提前实例化单例Bean对象
        beanFactory.preInstantiateSingletons();
    }

    /**
     * 获取所有实现了BeanPostProcessor的Bean,将它加到BeanPostProcessor执行链,getBeansOfType()返回的就是beanDefinitionMap的遍历顺序,也就是注册顺序
     * 即BeanPostProcessor执行链里执行的顺序是它的注册顺序
     * 如果需要改变执行的优先级,可以实现 PriorityOrdered 或 Ordered 接口
     * @param beanFactory
     */
    private void registerBeanPostProcessors(ConfigurableListableBeanFactory beanFactory) {
        Map<String, BeanPostProcessor> beanPostProcessorMap = beanFactory.getBeansOfType(BeanPostProcessor.class);
        for (BeanPostProcessor beanPostProcessor : beanPostProcessorMap.values()) {
            beanFactory.addBeanPostProcessor(beanPostProcessor);
        }
    }

    /**
     * 直接执行了BeanFactoryProcessor
     * @param beanFactory
     */
    private void invokeBeanFactoryPostProcessors(ConfigurableListableBeanFactory beanFactory) {
        Map<String, BeanFactoryPostProcessor> beanFactoryPostProcessorMap = beanFactory.getBeansOfType(BeanFactoryPostProcessor.class);
        for (BeanFactoryPostProcessor beanFactoryPostProcessor:beanFactoryPostProcessorMap.values()){
            beanFactoryPostProcessor.postProcessBeanFactory(beanFactory);
        }
    }

    /**
     * 门面+委托模式的应用,在这里再次实现getBeansOfType只是因为ApplicationContext是对用户使用的,
     * 这里再次实现只是提供一个门面,但是真正实现还是委托给DefaultListableBeanFactory去做
     * @param type
     * @return
     * @param <T>
     * @throws BeansException
     */
    @Override
    public <T> Map<String, T> getBeansOfType(Class<T> type) throws BeansException {
        return getBeanFactory().getBeansOfType(type);
    }

    @Override
    public String[] getBeanDefinitionNames() {
        return getBeanFactory().getBeanDefinitionNames();
    }

    @Override
    public Object getBean(String beanName) {
        return getBeanFactory().getBean(beanName);
    }

    @Override
    public Object getBean(String beanName, Object... args) {
        return getBeanFactory().getBean(beanName, args);
    }

    @Override
    public <T> T getBean(String name, Class<T> requiredType) throws BeansException {
        return getBeanFactory().getBean(name, requiredType);
    }

    protected abstract void refreshBeanFactory() throws BeansException;

    protected abstract ConfigurableListableBeanFactory getBeanFactory();
}

AbstractRefreshableApplicationContext抽象类

实现了父类AbstractApplicationContext的refreshBeanFactory()和getBeanFactory()方法
分担了父类AbstractApplicationContext的解析xml文件并创建beanFactory的职责
自己实现了创建beanFactory的功能
并且定义了抽象方法loadBeanDefinitions将解析xml文件的职责下发给子类

public abstract class AbstractRefreshableApplicationContext extends AbstractApplicationContext{
    private DefaultListableBeanFactory beanFactory;

    @Override
    protected void refreshBeanFactory() throws BeansException {
        DefaultListableBeanFactory beanFactory = createBeanFactory();
        loadBeanDefinitions(beanFactory);
        this.beanFactory = beanFactory;
    }

    protected abstract void loadBeanDefinitions(DefaultListableBeanFactory beanFactory);

    private DefaultListableBeanFactory createBeanFactory() {
        return new DefaultListableBeanFactory();
    }

    @Override
    protected ConfigurableListableBeanFactory getBeanFactory() {
        return this.beanFactory;
    }
}

AbstractXmlApplicationContext抽象类

负责解析配置文件并注册Bean的功能
定义抽象方法getConfigLocations()将获取配置文件的职责下发

public abstract class AbstractXmlApplicationContext extends AbstractRefreshableApplicationContext{
    @Override
    protected void loadBeanDefinitions(DefaultListableBeanFactory beanFactory) {
        XmlBeanDefinitionReader xmlBeanDefinitionReader = new XmlBeanDefinitionReader(this, beanFactory);
        String[] configLocations = getConfigLocations();
        if(null != configLocations && configLocations.length > 0) {
            xmlBeanDefinitionReader.loadBeanDefinitions(configLocations);
        }
    }

    protected abstract String[] getConfigLocations();
}

ClassPathXmlApplicationContext抽象类

负责获取xml文件
ClassPathXmlApplicationContext是这条继承链的终点,也是spring容器启动的起点
通过调用refresh()来启动容器

public class ClassPathXmlApplicationContext extends AbstractXmlApplicationContext {
    private String[] configLocations;

    public ClassPathXmlApplicationContext() {}

    public ClassPathXmlApplicationContext(String configLocation) {
        this(new String[]{configLocation});
    }

    public ClassPathXmlApplicationContext(String[] configLocations) {
        this.configLocations = configLocations;
        //开启容器启动流程
        refresh();
    }

    @Override
    protected String[] getConfigLocations() {
        return configLocations;
    }
}

spring容器内部在哪扩展?

BeanFactoryPostProcessor在AbstractApplicationContext抽象类的refresh()方法里直接执行,
而BeanPostProcessor只是在这里把所有实现了BeanPostProcessor的接口加入到BeanPostProcessor执行链。
而真正执行BeanPostProcessor是在Bean实例化之后,初始化前后,也就是AbstractAutowireCapableBeanFactory的createBean方法初始化前后

目前第七章的架构图

spring架构图.drawio

posted @ 2025-08-29 17:03  忧伤丶情语  阅读(4)  评论(0)    收藏  举报