自定义starter

1.前言

• springboot的最强大的就是那些xxxAutoconfiguration，可是这些xxxAutoConfiguration又依赖那些starter，只有导入了这些场景启动器（starter），咱们不少自动配置类才能有用，而且还会新增一些功能。

• 咱们要用一个场景（好比web），直接导入下面所示的依赖，可是在jar包里面去看这个，你会发现里面只有一些基本的配置文件，什么类都没有，就可以想到这个一类就相似一个公司前台的做用，经过这个公司前台，可以联系到公司内部。

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
  </dependency>

2.建立项目

2.1 建立一个空项目，在此基础上建立两个maven项目，具体见下图。

• db-spring-boot-starter用于编写自定义的starter
• test-db-spring-boot-starter用于测试

3.写xxxconfiguration里面的逻辑

3.1 配置目录结构

3.2 HelloProperties

@Data
@ConfigurationProperties(prefix = "db.hello")  //配置文件的前缀
public class HelloProperties {
    private String before;
    private String after;

}

• 这个配置类将 application.properties 中配置的属性值直接注入到这个实例中， @ConfigurationProperties 类型安全的属性注入，即将 application.properties 文件中前缀为 "db.hello"的属性注入到这个类对应的属性上

3.3 HelloWorld

• 此时这个类和properties类还没什么关系，必需要让第三方传入properties

  @Data
  public class HelloWorld {
      private HelloProperties properties;
  
      public String sayHelloWorld(String name) {
          return properties.getBefore() + ":" + name + "," + properties.getAfter();
      }
  }

3.4 HelloWorldAutoconfiguration

@Configuration //配置类
@ConditionalOnWebApplication //判断当前是web环境
@EnableConfigurationProperties(HelloProperties.class) //向容器里导入HelloProperties
public class HelloWorldAutoConfiguration {

    @Autowired
    HelloProperties properties;  //从容器中获取HelloProperties组件

    /**
     * 从容器里得到的组件传给HelloWorld，而后再将
     * HelloWorld组件丢到容器里
     * @return
     */
    @Bean
    public HelloWorld helloWorld() {
        HelloWorld helloWorld = new HelloWorld();
        helloWorld.setProperties(properties);
        return helloWorld;
    }
}

• 首先 @Configuration 注解代表这是一个配置类。
• @EnableConfigurationProperties 注解是使咱们以前配置的 @ConfigurationProperties 生效，让配置的属性成功的进入 Bean 中。
• @ConditionalOnWebApplication 表示当前项目是WEB项目的条件下,后面的配置才生效。
• 自动配置类中首先注入 HelloProperties ，这个实例中含有咱们在 application.properties 中配置的相关数据。
• 提供一个 helloWorld的实例，将 helloWorld中的值注入进去。

作完这一步以后，咱们的自动化配置类就算是完成了

3.5 spring.factories

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
cn.n3.db.HelloWorldAutoConfiguration

3.6 把这两个安装到maven本地仓库

• 先是xxautoconfiguration，而后再starter

• 到此为止，一个简单的HelloWorid的starter就作出来了，咱们只须要在咱们的项目中导入那个starter（也就是前台惟一的做用）的依赖，就能够了，看看个人starter的坐标（还要记住，properties文件配置的@ConfigurationProperties(prefix = "db.hello")，这个prefix是能够在咱们项目里面配置文件配置属性~~）

4.测试

4.1 新建一个测试模块，导入咱们本身的starter的坐标

4.2 修改配置

4.3编写controller

@Controller
public class TestController {

    @Autowired
    HelloWorld helloWorld;

    @RequestMapping("/hello")
    @ResponseBody
    public String sayHello() {
        return helloWorld.sayHelloWorld("test");
    }
}

4.4 启动 主启动类，浏览器访问

• 浏览器访问成功。

4.5 总结

• Spring Boot在启动时扫描项目所依赖的JAR包，寻找包含spring.factories文件的JAR包，
• 而后读取spring.factories文件获取配置的自动配置类AutoConfiguration
• 而后将自动配置类下知足条件(@ConditionalOnXxx)的@Bean放入到Spring容器中(Spring Context)
• 这样使用者就能够直接用来注入，由于该类已经在容器中了