Spring Boot 揭秘与实战自己实现一个简单的自动配置模块

书接上回，《Spring Boot 揭秘与实战源码分析 - 工作原理剖析》。为了更好的理解 Spring Boot 的自动配置和工作原理，我们自己来实现一个简单的自动配置模块。

博客地址：blog.720ui.com/

假设，现在项目需要一个功能，需要自动记录项目发布者的相关信息，我们如何通过 Spring Boot 的自动配置，更好的实现功能呢？

实战的开端 – Maven搭建

先创建一个Maven项目，我来手动配置下 POM 文件。


    4.0.0
    
        org.springframework.boot
        spring-boot-starter-parent
        1.3.3.RELEASE
     
    com.lianggzone.demo
    springboot-action-autoconfig
    0.1
    jar
    springboot-action-autoconfig
    
        
            org.springframework.boot
            spring-boot-autoconfigure
        
    
    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    
复制代码

参数的配置 - 属性参数类

首先，我们定义一个自定义前缀，叫做 custom 吧。之前说到，这里的配置参数，可以通过 application.properties 中直接设置。那么，我们创建一个作者的字段，设置默认值为 LiangGzone。

@ConfigurationProperties(prefix = "custom")
public class AuthorProperties {
    public static final String DEFAULT_AUTHOR = "LiangGzone";
    public String author = DEFAULT_AUTHOR;
    public String getAuthor() {
        return author;
    }
    public void setAuthor(String author) {
        this.author = author;
    }
}复制代码

那么，聪明的你，应该想到了，我们在 application.properties 中配置的时候，就要这样配置了。

#custom
custom.author = 梁桂钊复制代码

真的很简单 - 简单的服务类

public class AuthorServer {
    public String author;
    public String getAuthor() {
        return author;
    }
    public void setAuthor(String author) {
        this.author = author;
    }
}复制代码

你没有看错，真的是太简单了，没有高大上的复杂业务。它的主要用途就是赋值。

自动配置的核心 - 自动配置类

@ConditionalOnClass，参数中对应的类在 classpath 目录下存在时，才会去解析对应的配置类。因此，我们需要配置 AuthorServer 。

@EnableConfigurationProperties，用来加载配置参数，所以它应该就是属性参数类 AuthorProperties。

@Configuration
@ConditionalOnClass({ AuthorServer.class })
@EnableConfigurationProperties(AuthorProperties.class)
public class AuthorAutoConfiguration {
    @Resource
    private AuthorProperties authorProperties;
    @Bean
    @ConditionalOnMissingBean(AuthorServer.class)
    @ConditionalOnProperty(name = "custom.author.enabled", matchIfMissing = true)
    public AuthorServer authorResolver() {
        AuthorServer authorServer = new AuthorServer();
        authorServer.setAuthor(authorProperties.getAuthor());
        return authorServer;
    }
}复制代码

authorResolver方法的作用，即 AuthorProperties 的参数赋值到AuthorServer 中。

spring.factories 不要遗漏

我们需要实现自定义自动装配，就需要自定义 spring.factories 参数。所以，我们需要在 src/main/resources/ META-INF/spring.factories 中配置信息，值得注意的是，这个文件要自己创建。

# CUSTOM
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.lianggzone.springboot.autoconfig.author.AuthorAutoConfiguration复制代码

功能打包与配置依赖

好了，我们已经实现了一个简单的自动配置功能。那么，我们需要将这个项目打成 jar 包部署在我们的本地或者私服上。然后，就可以用了。

我们在另外一个项目中，配置 Maven 依赖。


    com.lianggzone.demo
    springboot-action-autoconfig
    0.1
复制代码

测试，测试

@RestController
@EnableAutoConfiguration
public class AuthorAutoConfigDemo {

    @Resource
    private AuthorServer authorServer;

    @RequestMapping("/custom/author")
    String home() {
        return "发布者："+ authorServer.getAuthor();
    }
}复制代码

运行起来，我们看下打印的发布者信息是什么？

我们在 application.properties 中配置一个信息。

#custom
custom.author = 梁桂钊复制代码

运行起来，我们看下打印的发布者信息是什么？

源代码

相关示例完整代码： springboot-action

（完）

更多精彩文章，尽在「服务端思维」微信公众号！

Spring Boot 揭秘与实战 自己实现一个简单的自动配置模块