Spring Boot 中的自动化配置 - Starter

我们使用 Spring Boot，基本上都是沉醉在它 Stater 的方便之中。Starter 为我们带来了众多的自动化配置，有了这些自动化配置，我们可以不费吹灰之力就能搭建一个生产级开发环境。

核心知识

其实 Starter 的核心就是条件注解 @Conditional ，当 classpath 下存在某一个 Class 时，某个配置才会生效。

定义自己的 Starter

定义

所谓的 Starter ，其实就是一个普通的 Maven 项目，因此我们自定义 Starter ，需要首先创建一个普通的 Maven 项目，创建完成后，添加 Starter 的自动化配置类即可，如下：

<dependency>
    <groupId>org.springframework.boot</groupId>    
    <artifactId>spring-boot-autoconfigure</artifactId>    <version>2.1.4.RELEASE</version></dependency>

配置完成后，我们首先创建一个 HelloProperties 类，用来接受 application.properties 中注入的值，如下：

@ConfigurationProperties(prefix = "javaboy")public class HelloProperties {    private static final String DEFAULT_NAME = "江南一点雨";    private static final String DEFAULT_MSG = "牧码小子";    private String name = DEFAULT_NAME;    private String msg = DEFAULT_MSG;    public String getName() {        return name;    }    public void setName(String name) {        this.name = name;    }    public String getMsg() {        return msg;    }    public void setMsg(String msg) {        this.msg = msg;    }}

这个配置类很好理解，将 application.properties 中配置的属性值直接注入到这个实例中， @ConfigurationProperties 类型安全的属性注入，即将 application.properties 文件中前缀为 javaboy 的属性注入到这个类对应的属性上， 最后使用时候，application.properties 中的配置文件，大概如下：

javaboy.name=zhangsanjavaboy.msg=java

关注类型安全的属性注入，可以参考：Spring Boot中的yaml配置简介

配置完成 HelloProperties 后，接下来我们来定义一个 HelloService ，然后定义一个简单的 say 方法， HelloService 的定义如下：

public class HelloService {    private String msg;    private String name;    public String sayHello() {        return name + " say " + msg + " !";    }    public String getMsg() {        return msg;    }    public void setMsg(String msg) {        this.msg = msg;    }    public String getName() {        return name;    }    public void setName(String name) {        this.name = name;    }}

定义自动配置类

@Configuration@EnableConfigurationProperties(HelloProperties.class)@ConditionalOnClass(HelloService.class)public class HelloServiceAutoConfiguration {    @Autowired    HelloProperties helloProperties;
    @Bean    HelloService helloService() {        HelloService helloService = new HelloService();        helloService.setName(helloProperties.getName());        helloService.setMsg(helloProperties.getMsg());        return helloService;    }}

关于这一段自动配置，解释如下：

•首先 @Configuration 注解表明这是一个配置类。•@EnableConfigurationProperties 注解是使我们之前配置的 @ConfigurationProperties 生效，让配置的属性成功的进入 Bean 中。•@ConditionalOnClass 表示当项目当前 classpath 下存在 HelloService 时，后面的配置才生效。•自动配置类中首先注入 HelloProperties ，这个实例中含有我们在 application.properties 中配置的相关数据。•提供一个 HelloService 的实例，将 HelloProperties 中的值注入进去。

做完这一步之后，我们的自动化配置类就算是完成了，接下来还需要一个 spring.factories 文件，那么这个文件是干嘛的呢？大家知道我们的 Spring Boot 项目的启动类都有一个 @SpringBootApplication 注解，这个注解的定义如下：

​​​​​

@SpringBootConfiguration@EnableAutoConfiguration@ComponentScan(excludeFilters = {        @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),        @Filter(type = FilterType.CUSTOM,                classes = AutoConfigurationExcludeFilter.class) })public @interface SpringBootApplication {}

大家看到这是一个组合注解，其中的一个组合项就是 @EnableAutoConfiguration ，这个注解是干嘛的呢？

@EnableAutoConfiguration 表示启用 Spring 应用程序上下文的自动配置，该注解会自动导入一个名为 AutoConfigurationImportSelector 的类,而这个类会去读取一个名为 spring.factories 的文件, spring.factories 中则定义需要加载的自动化配置类，我们打开任意一个框架的 Starter ，都能看到它有一个 spring.factories 文件，例如 MyBatis 的 Starter 如下：

那么我们自定义 Starter 当然也需要这样一个文件，我们首先在 Maven 项目的 resources 目录下创建一个名为 META-INF 的文件夹，然后在文件夹中创建一个名为 spring.factories 的文件，文件内容如下：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=org.javaboy.mystarter.HelloServiceAutoConfiguration

在这里指定我们的自动化配置类的路径即可。

如此之后我们的自动化配置类就算完成了。

本地安装

安装到本地仓库，然后在其他项目中使用即可。安装方式很简单，在 IntelliJ IDEA 中，点击右边的 Maven Project ，然后选择 Lifecycle 中的 install

使用 Starter

接下来，我们来新建一个普通的 Spring Boot 工程，这个 Spring Boot 创建成功之后，加入我们自定义 Starter 的依赖，如下：

<dependency>    <groupId>org.javaboy</groupId>    <artifactId>mystarter</artifactId>    <version>1.0-SNAPSHOT</version></dependency>

此时我们引入了上面自定义的 Starter ，也即我们项目中现在有一个默认的 HelloService 实例可以使用，而且关于这个实例的数据，我们还可以在 application.properties 中进行配置，如下：​​​​​​​

javaboy.name=牧码小子javaboy.msg=java

配置完成后，方便起见，我这里直接在单元测试方法中注入 HelloSerivce 实例来使用，代码如下：​​​​​​​

@RunWith(SpringRunner.class)@SpringBootTestpublic class UsemystarterApplicationTests {
    @Autowired    HelloService helloService;    @Test    public void contextLoads() {        System.out.println(helloService.sayHello());    }}

执行单元测试方法，打印日志如下：

好了，一个简单的自动化配置类我们就算完成了，是不是很简单！

总结

本文的案例，已上传到 GitHub上了，地址：https://github.com/lenve/javaboy-code-samples。

转载于:https://my.oschina.net/u/3635618/blog/3097620