Spring Boot Starter 开发指南

Spring Boot Starter是什么？

依赖管理是任何复杂项目的关键部分。以手动的方式来实现依赖管理不太现实，你得花更多时间，同时你在项目的其他重要方面能付出的时间就会变得越少。

Spring Boot starter 就是为了解决这个问题而诞生的。Starter POM 是一组方便的依赖描述符，您可以将其包含在应用程序中。您可以获得所需的所有 Spring 和相关技术的一站式服务，无需通过示例代码搜索和复制粘贴依赖。

揭开Spring Boot自动装配的神秘面纱

Auto Configuration 类

当Spring Boot启动时，它会在类路径中查找名为spring.factories的文件。该文件位于META-INF目录中。让我们看一下spring-boot-autoconfigure项目中这个文件的片段：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
org.springframework.boot.autoconfigure.amqp.RabbitAutoConfiguration,\
org.springframework.boot.autoconfigure.cassandra.CassandraAutoConfiguration,\
org.springframework.boot.autoconfigure.mongo.MongoAutoConfiguration,\
org.springframework.boot.autoconfigure.orm.jpa.HibernateJpaAutoConfiguration

此文件定义了一些Spring Boot将尝试运行的自动装配类。例如以上的代码片段，Spring Boot将尝试运行RabbitMQ，Cassandra，MongoDB和Hibernate的所有配置类。这些类是否实际运行将取决于类路径上是否存在依赖类。例如，如果在类路径中找到MongoDB的类，则将运行MongoAutoConfiguration，并初始化所有与mongo相关的bean。此条件初始化由@ConditionalOnClass注释启用。让我们看一下MongoAutoConfiguration类的代码片段，看看它的用法：

@Configuration
@ConditionalOnClass(MongoClient.class)
@EnableConfigurationProperties(MongoProperties.class)
@ConditionalOnMissingBean(type = "org.springframework.data.mongodb.MongoDbFactory")
public class MongoAutoConfiguration {
    // configuration code
}

如果存在MongoClient类，将运行该自动装配类初始化MongoClient相关bean。

在application.properties自定义配置

Spring Boot使用一些预先配置的默认值初始化bean。要覆盖这些默认值，我们通常会在application.properties文件中使用某个特定名称声明它们。Spring Boot容器会自动获取这些属性。

在MongoAutoConfiguration的代码片段中，@EnableConfigurationProperties(MongoProperties.class)表示，使用MongoProperties类来声明自定义属性：

@ConfigurationProperties(prefix = "spring.data.mongodb")
public class MongoProperties {

    private String host;

    // other fields with standard getters and setters
}

@ConfigurationProperties(prefix = "spring.data.mongodb")定义了配置前缀，我们可以在application.properties这样来使用它：

spring.data.mongodb.host = localhost

这样，初始化的时候，localhost将被注入到host属性中

自定义Spring Boot Starter

Spring Boot自动装配虽然神奇，但是编写起来却异常简单，我们只需要按部就班的执行以下两个流程：

1. 编写属性容器*Properties，并编写对应的*AutoConfiguration自动装配类
2. 一个pom文件，用于定义引入库和自动装配类的依赖项

概念解析

用于*Properties的注解

• @ConfigurationProperties(prefix = "spring.data.mongodb") ：用于指定配置前缀

用于*AutoConfiguration的注解

• @Configuration：标记为配置类，由Spring容器初始化并接管
• @EnableConfigurationProperties：注入配置属性容器
• @ConditionalOnBean：条件装配

重点说下条件装配，以@ConditionalOnBean为例，当Spring容器中存在指定Bean的时候装配

@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnBeanCondition.class)
public @interface ConditionalOnBean{
    //properties
}

@Conditional(OnBeanCondition.class)指定了实现条件装配的逻辑代码

OnBeanCondition声明如下：

class OnBeanCondition extends SpringBootCondition implements ConfigurationCondition{}

所以，我们自己也可以继承SpringBootCondition并实现ConfigurationCondition来自定义条件装配注解。

比较常用的几个条件装配注解：

• @ConditionalOnBean：当Spring容器中存在指定Bean时装配
• @ConditionalOnClass：当存在指定Class时装配
• @ConditionalOnMissingBean：当Spring容器中不存在指定Bean时装配
• @ConditionalOnMissingClass：当不存在指定Class时装配

小试牛刀

我们将自动配置模块称为greeter-spring-boot-autoconfigure。该模块将有两个主要类，即GreeterProperties，它将通过application.properties文件和GreeterAutoConfiguartion设置自定义属性，并为greeter库创建bean。

准备，创建假想的一个第三方工程：Greet

public class Greeter {
    private GreetingConfig greetingConfig;

    public Greeter(GreetingConfig greetingConfig) {
        this.greetingConfig = greetingConfig;
    }

    public String greet(LocalDateTime localDateTime) {

        String name = greetingConfig.getProperty(USER_NAME);
        int hourOfDay = localDateTime.getHour();

        if (hourOfDay >= 5 && hourOfDay < 12) {
            return String.format("Hello %s, %s", name, greetingConfig.get(MORNING_MESSAGE));
        } else if (hourOfDay >= 12 && hourOfDay < 17) {
            return String.format("Hello %s, %s", name, greetingConfig.get(AFTERNOON_MESSAGE));
        } else if (hourOfDay >= 17 && hourOfDay < 20) {
            return String.format("Hello %s, %s", name, greetingConfig.get(EVENING_MESSAGE));
        } else {
            return String.format("Hello %s, %s", name, greetingConfig.get(NIGHT_MESSAGE));
        }
    }

    public String greet() {
        return greet(LocalDateTime.now());
    }
}

public class GreeterConfigParams {
    public static final String USER_NAME = "user.name";
    public static final String MORNING_MESSAGE = "morning.message";
    public static final String AFTERNOON_MESSAGE = "afternoon.message";
    public static final String EVENING_MESSAGE = "evening.message";
    public static final String NIGHT_MESSAGE = "night.message";
}

public class GreetingConfig extends Properties {
    private static final long serialVersionUID = 5662570853707247891L;
}

编写Properties和AutoConfiguration：

@ConfigurationProperties(prefix = "gcdd1993.greeter")
public class GreeterProperties {
    private String userName;
    private String morningMessage;
    private String afternoonMessage;
    private String eveningMessage;
    private String nightMessage;
    // getter and setter
}

@Configuration
@ConditionalOnClass(Greeter.class)
@EnableConfigurationProperties(GreeterProperties.class)
public class GreeterAutoConfiguration {
    @Autowired
    private GreeterProperties greeterProperties;

    @Bean
    @ConditionalOnMissingBean
    public GreetingConfig greeterConfig() {

        String userName = greeterProperties.getUserName() == null
                ? System.getProperty("user.name")
                : greeterProperties.getUserName();
        GreetingConfig greetingConfig = new GreetingConfig();
        greetingConfig.put(USER_NAME, userName);
        if (greeterProperties.getMorningMessage() != null) {
            greetingConfig.put(MORNING_MESSAGE, greeterProperties.getMorningMessage());
        }
        if (greeterProperties.getAfternoonMessage() != null) {
            greetingConfig.put(AFTERNOON_MESSAGE, greeterProperties.getAfternoonMessage());
        }
        if (greeterProperties.getEveningMessage() != null) {
            greetingConfig.put(EVENING_MESSAGE, greeterProperties.getEveningMessage());
        }
        if (greeterProperties.getNightMessage() != null) {
            greetingConfig.put(NIGHT_MESSAGE, greeterProperties.getNightMessage());
        }
        return greetingConfig;
    }

    @Bean
    @ConditionalOnMissingBean
    public Greeter greeter(GreetingConfig greetingConfig) {
        return new Greeter(greetingConfig);
    }
}

然后在src/main/resources/META-INF目录下创建spring.factories文件

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
  com.gcdd.autoconfigure.GreeterAutoConfiguration

测试一下：

1. 创建配置文件application.properties：

gcdd1993.greeter.userName=gcdd1993
gcdd1993.greeter.eveningMessage=good evening

1. 使用Greeter bean

@SpringBootApplication
public class GreeterSampleApplication implements CommandLineRunner {
    @Autowired
    private Greeter greeter;

    public static void main(String[] args) {
        SpringApplication.run(GreeterSampleApplication.class, args);
    }

    @Override
    public void run(String... args) throws Exception {
        String message = greeter.greet();
        System.out.println(message);
    }
}

执行main方法，将会输出一行：

Hello gcdd1993, good evening

为配置类添加提示

我们知道，在Idea中，编写配置文件的时候，有智能提示

其实这不是Idea搞的鬼，是由META-INF/spring-configuration-metadata.json文件配置好的，Idea只是负责解析这个文件，提供我们智能化的提示信息。

想要达到这个目的很简单，添加依赖org.springframework.boot:spring-boot-configuration-processor就行了。

Maven

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <version>2.1.6.RELEASE</version>
</dependency>

Gradle

compile group: 'org.springframework.boot', name: 'spring-boot-configuration-processor', version: '2.1.6.RELEASE'

总结

以上就是Spring Boot Starter的全部内容了，如果要发布到maven仓库，供别人使用，可以使用mvn install打包发布至maven仓库。