深入理解 Spring @Import 不同方式注册 Bean

简介: 深入理解 Spring @Import 不同方式注册 Bean

每日一言


苦,是人生的必经过程。人生就是一个 "享受" 痛苦和磨难的过程,这个过程是值得体会和拥有的

前言


Spring 在 3.0 版本之前都是通过 .xml 配置文件的形式来描述配置信息

在配置文件中显示声明 bena 标签或者扫描特定包下的类来注册 IOC 容器 Bean 对象等操作

@Import 是 Spring 3.0 之后通过 JavaConfig 方式提供注册 IOC Bean 的注解

需要配合 @Configuration 注解共同使用才能起作用,因为只有这样才会被 Spring 加载时扫描到

小伙伴阅读文章将收获:

  1. @Import 日常使用方法
  2. ImportBeanDefinitionRegistrar 配合 @Import 注册 Bean
  3. ImportSelector 配合 @Import 注册 Bean
  4. JavaConfig 方式引入 spring.xml 配置文件注册 Bean

@Import 使用


先来看一下源码里是如何介绍这个小可爱的

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Import {

    /**
     * {@link Configuration @Configuration}, {@link ImportSelector},
     * {@link ImportBeanDefinitionRegistrar}, or regular component classes to import.
     */
    Class<?>[] value();

}

源码类注释太长就不贴出来水字数了, 通过贴心的翻译软件,结论如下:

  1. 表示要导入一个或多个普通、配置类(@Configuration ),将导入对象转换为 Spring IOC Bean
  2. 支持 ImportBeanDefinitionRegistrar、ImportSelector 针对需要注册的 Bean 做更细致的填充
  3. 如果使用的是 .xml 配置文件的形式注册 Bean,那么可以使用 @ImportResource
  4. 通过导入注册的 Bean 对象可以正常被 @Autowired 注入
微信搜索【源码兴趣圈】,关注龙台,回复【资料】领取涵盖 GO、Netty、SpringCLoud Alibaba、Seata、开发规范、面试宝典、数据结构等电子书 or 视频学习资料!

先来简单看一下如何使用 @Import 来注册 Bean

@Configuration
@Import(ImportBeanTest.ServiceBean.class)
public class ImportBeanTest implements ApplicationContextAware, BeanFactoryPostProcessor {
    
  private ApplicationContext applicationContext;

    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory configurableListableBeanFactory) throws BeansException {
        System.out.println("注册 ServiceBean 对象 :: " + applicationContext.getBean(ServiceBean.class));
    }

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        this.applicationContext = applicationContext;
    }

    static class ServiceBean {}
}

上面程序为了偷懒,直接使用了两个 Spring 接口,简单介绍下各自的作用

  • ApplicationContextAware:为了获取 ApplicationContext 上下文对象,用来应该被注册的 Bean 实例
  • BeanFactoryPostProcessor:后置处理器,程序用在查询 Bean 是否被注册 IOC 容器

这个使用了 @Import 注解的程序流程如下:

  1. 类标记 @Configuration 表示是配置类,并通过 @Import 导入 ServiceBean
  2. 通过 ApplicationContextAware 接口获取 ApplicationContext 上下文
  3. 在后置处理器中,查看 ServiceBean 是否被注册成功

如果项目启动后能够正常打印对象信息,即注册成功

@Configuration


小伙伴这次可以看到,@Import 中导入的类是被 @Configuration 所修饰的,也就意味着导入了一个配置类,同时其下包含多个 @Bean 方法

配置类中相关的 Bean 同时也会被加载

@Configuration
@Import(ImportConfigurationTest.ImportConfiguration.class)
public class ImportConfigurationTest implements ApplicationContextAware, BeanFactoryPostProcessor {

    private ApplicationContext applicationContext;

    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory configurableListableBeanFactory) throws BeansException {
        System.out.println("注册 ServiceBeanA 对象 :: " + applicationContext.getBean(ServiceBeanA.class));
        System.out.println("注册 ServiceBeanB 对象 :: " + applicationContext.getBean(ServiceBeanB.class));
    }

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        this.applicationContext = applicationContext;
    }

    @Configuration
    static class ImportConfiguration {

        @Bean
        public ServiceBeanA getServiceBeanA() {return new ServiceBeanA();}

        @Bean
        public ServiceBeanB getServiceBeanB() {return new ServiceBeanB();}
    }

    static class ServiceBeanA {} static class ServiceBeanB {}
}

导入 @Configuration 和导入普通 Java Class 对象作用是一致的,相比于有两点好处:

  1. 创建 Bean 时定义对应的方法以及属性值等操作
  2. 将同一类型的 Bean 归结到一起,方便代码编写

ImportSelector


ImportSelector 是一个接口,通过 @Import 进行导入,和 @Configuration 修饰类相似

两者作用域都是将多个类进行注入 IOC 容器,不同的是 ImportSelector 是将类的全限定名当作 IOC 容器的 ID

@Configuration
@Import(ImportSelectorTest.RegistryConfig.class)
public class ImportSelectorTest implements ApplicationContextAware, BeanFactoryPostProcessor {

    private ApplicationContext applicationContext;

    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory configurableListableBeanFactory) throws BeansException {
        System.out.println("注册 ServiceBeanA 对象 :: " + applicationContext.getBean(ServiceBeanA.class));
        System.out.println("注册 ServiceBeanB 对象 :: " + applicationContext.getBean(ServiceBeanB.class));
    }

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        this.applicationContext = applicationContext;
    }

    static class RegistryConfig implements ImportSelector {
        @Override
        public String[] selectImports(AnnotationMetadata importingClassMetadata) {
            return new String[]{ServiceBeanA.class.getName(), ServiceBeanB.class.getName()};
        }
    }

    static class ServiceBeanA {} static class ServiceBeanB {}
}

selectImports 方法中的入参,存放的都是 类元信息,通过已序列化的 JSON 串看一下

另外通过后置处理器中,我们可以看到相关类已被注册,ID即是类全限定名称

ImportBeanDefinitionRegistrar


ImportBeanDefinitionRegistrar 是一个接口,@Import 中可以加入此接口的实现

@Configuration
@Import(ImportBeanDefinitionRegistrarTest.RegistrarConfig.class)
public class ImportBeanDefinitionRegistrarTest implements ApplicationContextAware, BeanFactoryPostProcessor {

    private ApplicationContext applicationContext;

    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory configurableListableBeanFactory) throws BeansException {
        System.out.println("注册 ServiceBean 对象 :: " + applicationContext.getBean(ServiceBean.class));
    }

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        this.applicationContext = applicationContext;
    }

    static class RegistrarConfig implements ImportBeanDefinitionRegistrar {
        @Override
        public void registerBeanDefinitions(AnnotationMetadata importingClassMetadata, BeanDefinitionRegistry registry) {
            BeanDefinition beanDefinition = BeanDefinitionBuilder
                    .genericBeanDefinition(ServiceBean.class)
                    .getBeanDefinition();
            registry.registerBeanDefinition("serviceBean", beanDefinition);
        }
    }

    static class ServiceBean {}
}

可以看到 registerBeanDefinitions 方法入参中不仅有类元信息,同时还包含 Bean 注册接口

同时可以为属性值、构造方法参数值以及更多实现信息进行赋值,不仅仅是示例代码中那么简单

@ImportResource


如果说,你在用 Spring 或 SpringBoot 项目,需要使用 JavaConfig 这种方式来导入 .xml 文件运行

@ImportResource 绝对是救命稻草,但是作者认为 SpringBoot 项目更适合 JavaConfig 的方式进行配置

registry.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"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd">

    <bean id="serviceBean"
          class="cn.machen.study.springstudy.bean.importx.ImportResourceTest.ServiceBean" />

</beans>

ImportResourceTest.java

@Configuration
@ImportResource(locations = "classpath:registry.xml")
public class ImportResourceTest implements ApplicationContextAware, BeanFactoryPostProcessor {

    private ApplicationContext applicationContext;

    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory configurableListableBeanFactory) throws BeansException {
        System.out.println("注册 ServiceBean 对象 :: " + applicationContext.getBean(ImportResourceTest.ServiceBean.class));
    }

    @Override
    public void setApplicationContext(ApplicationContext applicationContext) throws BeansException {
        this.applicationContext = applicationContext;
    }

    static class ServiceBean {}
}

结言


文章从最开始的 @Import 开始,讲述了注册普通 Java 类、@Configuration 修饰类、ImportSelector、ImportBeanDefinitionRegistrar 等方式以 JavaConfig 的形式注册 IOC Bean,同时也介绍了通过 @ImportResource 导入 .xml 配置文件的方式配置,希望在看的小伙伴都有所收获

推荐阅读:

  1. 【强烈推荐】谨慎使用 JDK 8 新特性并行流 ParallelStream
  2. 【强烈推荐】一文快速掌握 Redisson 如何实现分布式锁原理
  3. 【大厂面试真题】JDK 线程池中如何不超最大线程数快速消费任务
  4. 【大厂面试真题】JDK 线程池如何保证核心线程不被销毁
相关文章
|
1月前
|
XML Java 测试技术
Spring5入门到实战------17、Spring5新功能 --Nullable注解和函数式注册对象。整合JUnit5单元测试框架
这篇文章介绍了Spring5框架的三个新特性:支持@Nullable注解以明确方法返回、参数和属性值可以为空;引入函数式风格的GenericApplicationContext进行对象注册和管理;以及如何整合JUnit5进行单元测试,同时讨论了JUnit4与JUnit5的整合方法,并提出了关于配置文件加载的疑问。
Spring5入门到实战------17、Spring5新功能 --Nullable注解和函数式注册对象。整合JUnit5单元测试框架
|
6天前
|
缓存 安全 Java
Spring框架中Bean是如何加载的?从底层源码入手,详细解读Bean的创建流程
从底层源码入手,通过代码示例,追踪AnnotationConfigApplicationContext加载配置类、启动Spring容器的整个流程,并对IOC、BeanDefinition、PostProcesser等相关概念进行解释
Spring框架中Bean是如何加载的?从底层源码入手,详细解读Bean的创建流程
|
6天前
|
XML Java 数据格式
Spring IOC—基于XML配置Bean的更多内容和细节(通俗易懂)
Spring 第二节内容补充 关于Bean配置的更多内容和细节 万字详解!
57 18
Spring IOC—基于XML配置Bean的更多内容和细节(通俗易懂)
|
1月前
|
XML Java 数据格式
Spring5入门到实战------8、IOC容器-Bean管理注解方式
这篇文章详细介绍了Spring5框架中使用注解进行Bean管理的方法,包括创建Bean的注解、自动装配和属性注入的注解,以及如何用配置类替代XML配置文件实现完全注解开发。
Spring5入门到实战------8、IOC容器-Bean管理注解方式
|
29天前
|
Java Spring
|
30天前
|
前端开发 Java 开发者
|
30天前
|
缓存 Java Maven
Java本地高性能缓存实践问题之SpringBoot中引入Caffeine作为缓存库的问题如何解决
Java本地高性能缓存实践问题之SpringBoot中引入Caffeine作为缓存库的问题如何解决
|
2月前
|
Java 测试技术 数据库
Spring Boot中的项目属性配置
本节课主要讲解了 Spring Boot 中如何在业务代码中读取相关配置,包括单一配置和多个配置项,在微服务中,这种情况非常常见,往往会有很多其他微服务需要调用,所以封装一个配置类来接收这些配置是个很好的处理方式。除此之外,例如数据库相关的连接参数等等,也可以放到一个配置类中,其他遇到类似的场景,都可以这么处理。最后介绍了开发环境和生产环境配置的快速切换方式,省去了项目部署时,诸多配置信息的修改。
|
2月前
|
Java 应用服务中间件 开发者
Java面试题:解释Spring Boot的优势及其自动配置原理
Java面试题:解释Spring Boot的优势及其自动配置原理
96 0
|
1天前
|
Java 应用服务中间件 开发者
深入探索并实践Spring Boot框架
深入探索并实践Spring Boot框架
13 2