年轻人的第一个自定义 Spring Boot Starter！

陆陆续续，零零散散，栈长已经写了几十篇 Spring Boot 系列文章了，其中有介绍到 Spring Boot Starters 启动器，使用的、介绍的都是第三方的 Starters ，那如何开发一个本身的 Spring Boot Starter 呢？

下面带你们开发一个年轻人的第一个 Spring Boot Starter！

不知道 Starters 为什么物的请进这个传送门===>
Spring Boot Starters 启动器，看完有了学习基础，咱们再继续下面的自定义 Starter 实战！

1、自定义 Starter 必备组件

一个完整的 Spring Boot Starter 须要包含如下组件：

• 包含自动配置代码的自动配置模块；参考：Spring Boot自动配置原理、实战。
• Starter模块提供对自动模块的依赖关系，和相关依赖库，以及任何须要用到的依赖。简而言之，就是，添加一个 Starter 就应该提供使用该 Starter 所需的一切；

2、建立一个自定义Starter

怎么建立 Spring Boot 项目就不说了，以前也分享过，参考：年轻人的第一个 Spring Boot 应用！。

这个自定义 Starter 就实现一个根据属性的值是否配置Bean。

一、建立自动配置类

package cn.javastack.springboot.starter.config;

import cn.javastack.springboot.starter.service.TestService;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
@ConditionalOnProperty(prefix = "javastack.starter", name = "enabled", havingValue = "true")
public class TestServiceAutoConfiguration {

    @Bean
    public TestService testService() {
        return new TestService();
    }

}

这个自动配置类很简单，就是根据是否有 javastack.starter.enabled=true 这个参数的值再配置一个Bean。

TestService示例以下：

package cn.javastack.springboot.starter.service;

public class TestService {

    public String getServiceName() {
        return "Java技术栈";
    }

}

这个类就有一个方法 getServiceName，它就返回一个字符串：Java技术栈。

二、容许自动配置

建立 META-INF/spring.factories 文件，添加这个容许自动配置的类。

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
cn.javastack.springboot.starter.config.TestServiceAutoConfiguration

3、测试这个自定义Starter

上面的自定义 Starter 项目建好后，能够来测试一下它是否生效了。

通常是把它打成 jar 包上传到 Maven 仓库，供其余同事调用，这里咱们本报打完包以后再引用它。

一、添加依赖

新建一个 Spring Boot 测试项目，添加这个自定义 Starter 依赖，Maven 依赖以下：

<dependencies>
    <dependency>
        <groupId>cn.javastack</groupId>
        <artifactId>javastack-spring-boot-starter</artifactId>
        <version>1.0</version>
        <scope>compile</scope>
    </dependency>
</dependencies>

二、添加测试方法

package cn.javastack.springboot.starter.sample;

import cn.javastack.springboot.starter.service.TestService;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;

/**
 * 微信公众号：Java技术栈
 */
@SpringBootApplication
public class Application {

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

    @Bean
    public CommandLineRunner commandLineRunner(TestService testService) {
        return (args) -> {
            System.out.println(testService.getServiceName());
        };
    }

}

这个方法的做用是，项目启动后，调用 TestService 的实例方法，输出方法的值。

关于 CommandLineRunner 有不懂的能够看这篇文章：Spring Boot Runner 启动器。

三、开启配置

咱们知道这个自定义 Starter 中须要有 javastack.starter.enabled=true 这个参数的值的，因此咱们在 application.yml 配置文件中添加这个配置：

javastack:
  starter:
    enabled: true

四、运行测试

运行 Application 类的 main 方法，最后会输出结果：Java技术栈。

当咱们把配置改成：

javastack:
  starter:
    enabled: false

此时，运行报错，由于没有这个实例啊，自动配置类只有为 true 时才会配置。

4、总结

本章栈长简单演示了如何自定义一个 Spring Boot Starter，根据某个参数的值来决定是否自动配置，其实还能够根据是否有某个类、某个Bean……等，能够看下《Spring Boot 最核心的 25 个注解》这篇文章对应的 ConditionOnXXX 系列注解。

其实了解了 Spring Boot 自动配置的原理，自定义一个 Starter 并不难，你能够在这个实例基础上灵活扩展。

本文完整的代码实例 Github 地址：

https://github.com/javastacks...

赶忙关注加星吧，已经更新一大堆教程了，后续这个教程会持续更新……

本文原创首发于微信公众号：Java技术栈（id:javastack），关注公众号在后台回复 "boot" 可获取更多 Spring Boot 教程，转载请原样保留本信息。