Spring

Spring Boot 自动配置理解与实践

2019-11-04  本文已影响0人  tuacy

一 自动配置理解

        Spring Boot提倡通过注解(annotation)来进行Bean的配置。最终达到零配置,开箱即用的效果。我们可以简单的认为Spring Boot里面有两种创建Bean的方式:configure(即@Configuration注解的使用)和auto-configure(即@EnableAutoConfiguration注解的使用)。

       这两者对Bean的配置是有很大的区别的?

       有可能你会有这样的疑问,auto-configure是怎么起作用的呢。自动配置的入口是@EnableAutoConfiguration注解,那为啥我们没有显示的添加@EnableAutoConfiguration注解呢,因为我们一般创建SpringBoot工程的时候都会在启动类上添加@SpringBootApplication注解,而@SpringBootApplication注解已经包含了@EnableAutoConfiguration注解。所有咱们没有显示的去添加@EnableAutoConfiguration注解。这样SpringBoot在启动的过程中发现有添加@EnableAutoConfiguration注解。就会去找所有我们项目依赖的jar包,然后会在jar包里面META-INF/spring.factories文件读取到org.springframework.boot.autoconfigure.EnableAutoConfigurationn指定的类。然后根据这些类所指定的条件创建这些类里面添加了@Bean方法对应的Bean,并且把这些Bean添加到IOC容器里面去。

clipboard.png

      上面讲了一大堆,那么auto-configure具体的作用是啥呢。auto-configure的目的就是让第三方jar里面的类可以很方便的添加到IOC容器里面去。让我们在项目中可以直接使用,最终达到开箱即用的状态。SpringBoot里面的spring-boot-starters就是通过自动配置的方式来实现的。在实际开发过程中我们也可以仿照starter的实现方式,来提供自定义的的starter(关于这一点,我们会在后文中以一个具体的例子来讲)。总之自动配置让让我们可以更好的维护复杂的项目。通过自动配置的方式第三方jar里面的Bean在我们的项目中拿来用就可以了。真正的开箱即用.

      关于自动配置有一点要强调,自动配置使用的时候还可以通过@AutoConfigureAfter,@AutoConfigureBefore和@AutoConfigureOrder这类的注解来指定加载顺序。有一点也要特别注意,如果自动配置提供的类名称在@ComponentScan扫描的路径之中,SpringBoot会把这些类作为configuration先给处理了,这个时候@AutoConfigureAfter,@AutoConfigureBefore和@AutoConfigureOrder这类指定顺序的注解都会失效的。千万千万要记住。

二 自动配置实践

      接下来,我们通过自定义的Spring Boot Starter.来了解下自定配置实践的使用。我们心里一定要明确自动配置的目的就是让第三方jar里面的类可以很方便的添加到IOC容器里面去。

      一个完整的Spring Boot Starter一般包含三个模块:第三方库(Bean的具体实现)模块、auto-configuration模块、starter模块。他们三者之间的关系如下图所示。

spring-boot-starter.png

如果你不需要区分这两个概念的话,也可以将自动配置代码模块与依赖管理模块合并成一个模块。

2.1 第三方库(Bean的具体实现)

      第三方库(Bean的具体实现),自动配置的目的就是为了让第三方的类可以添加到IOC容器里面,让我们在SpringBoot工程里面使用。这个模块就是我们需要添加到IOC容器里面去的Bean的具体实现。例如redis-starter则,该模块对应的就是redis操作的一些封装比如redis连接、读取缓存等等一些操作。

      我们实现一个email-starter。我们简单的创建一个email项目。最后会把他们打成一个jar包。里面就是发送邮件的具体逻辑实现。我们就在email项目添加一个类EmailService模拟邮件的发送。如下代码。后续我们会把EmailService添加到IOC容器里面去。

public class EmailService {

    private String sendEmail;
    private String sendPassword;

    public EmailService(String sendEmail, String sendPassword) {
        this.sendEmail = sendEmail;
        this.sendPassword = sendPassword;
    }

    /**
     * 模拟发送邮件
     *
     * @param toEmail 发送邮件的目的地址
     * @param content 发送邮件的内容
     */
    public void sendEmail(String toEmail, String content) {
        // 这里我们就不做具体的逻辑了,我们就简单的打印
        System.out.println("发送邮件成功");
        System.out.println("从 " + sendEmail + "发送给" + toEmail);
        System.out.println("邮件内容:" + content);
    }
}

      最终打包成email-1.0-SNAPSHOT.jar

2.2 auto-configuration模块

      auto-configuration模块包含自动配置的代码,里面会根据各种条件注解把根据需求把第三方jar里面的类对象添加到IOC容器里面去。而且该模块会在resource目录下添加META-INF/spring.factories文件配置org.springframework.boot.autoconfigure.EnableAutoConfiguration对应的自动配置类。

      auto-configuration模块命名规范

      auto-configuration模块pom文件,有两个是标配的依赖spring-boot-autoconfigure和spring-boot-configuration-processor,一个是自动配置的核心依赖,另一个如果我们自动配置需要用到什么自定义属性的时候(application.yml配置文件里面自定义属性)IDE的智能提示,剩下的就是auto-configuration模里面需要用到的其他依赖,比如我们需要对我们上面的email模块做自动配置,所以添加我们上面的email模块,这里要特别注意这里依赖没有往下传递添加了<scope>compile</scope>控制住了。因为在使用的时候我们需要控制当EmailService类存在的时候才会添加到IOC容器里面去。

        <!-- 自动配置核心依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-autoconfigure</artifactId>
        </dependency>

        <!-- 用于IDE配置文件自定义属性时候的智能提示 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
            <optional>true</optional>
        </dependency>

        <!-- 需要的第三方库,注意这里设置只在编译器有效 -->
        <dependency>
            <groupId>com.tuacy</groupId>
            <artifactId>email</artifactId>
            <version>1.0-SNAPSHOT</version>
            <scope>compile</scope>
            <optional>true</optional>
        </dependency>

关于SpringBoot里面添加注解的使用,可以自己去google下哦。

      自动配置类的实现EmailAutoConfigure。如果存在EmailService类,我们就把EmailService对象条件到IOC容器里面去。EmailProperties用于去配置文件里面读取自定义的属性。

@Configuration
@EnableConfigurationProperties(EmailProperties.class)
public class EmailAutoConfigure {

    /**
     * 一些属性配置
     */
    private final EmailProperties emailProperties;

    public EmailAutoConfigure(EmailProperties emailProperties) {
        this.emailProperties = emailProperties;
    }

    /**
     * 需要自动配置的Bean,这样该Bean就可以在添加了starter包的项目里面直接哪里啊用就可以了
     *
     * @return EmailService
     */
    @Bean
    @ConditionalOnClass(EmailService.class)
    @ConditionalOnMissingBean
    public EmailService emailService() {
        return new EmailService(emailProperties.getSendEmail(), emailProperties.getSendPassword());
    }

}

@ConfigurationProperties("email")
public class EmailProperties {

    private String sendEmail;
    private String sendPassword;

    public String getSendEmail() {
        return sendEmail;
    }

    public void setSendEmail(String sendEmail) {
        this.sendEmail = sendEmail;
    }

    public String getSendPassword() {
        return sendPassword;
    }

    public void setSendPassword(String sendPassword) {
        this.sendPassword = sendPassword;
    }
}

      spring.factories文件添加我们自动配置类EmailAutoConfigure

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
   com.tuacy.autoconfigure.email.configure.EmailAutoConfigure

      最后打包成email-spring-boot-autoconfigure-1.0-SNAPSHOT.jar

2.3 starter模块

      starter是一个空jar。它的目的是提供提供对auto-configure模块的依赖,和auto-configure模块需要的依赖。

      starter模块命名规范

      starter模块,主要是pom文件。一个是添加autoconfigure依赖,一个是添加autoconfigure模块里面需要的依赖(SpringBoot里面添加注解的使用)。

    <dependencies>

        <dependency>
            <groupId>com.tuacy</groupId>
            <artifactId>email</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>

        <dependency>
            <groupId>com.tuacy</groupId>
            <artifactId>email-spring-boot-autoconfigure</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>

    </dependencies>

      最后打包成email-spring-boot-starter-1.0-SNAPSHOT.jar。这样在SpringBoot项目里面就可以使用这个starter包了。从而使用我们的EmailService类了。


      实例代码下载地址,https://github.com/tuacy/java-study 对应地址里面的,emai,email-spring-boot-autoconfigure,email-spring-boot-starter三个module里面对应的代码。

image.png
上一篇下一篇

猜你喜欢

热点阅读