SpringBoot起飞系列-自定义starter（十）

一、前言

到现在，我们可以看出来，如果我们想用一些功能，基本上都是通过添加spring-boot-starter的方式来使用的，因为各种各样的功能都被封装成了starter，然后把相关服务注入到容器中去，那么如果我们想用一下自己的某些功能呢，那就也要编写一个自定义的starter，所以今天我们就来看看，怎么编写自己的starter，来实现在springboot中实现自己想要的一些功能。

二、原理

回想一下， 当我们使用一个官方的starter的时候，只需要将相应的starter依赖包添加到pom.xml中去就可以了，然后maven自动下载依赖包，并且springboot在启动后会自动配置相关的服务，然后注入的到容器中去。那么springboot是如何知道要去调用哪些方法，加载哪些配置，并注入哪些bean呢？

基本步骤如下：

1.首先，springboot在启动的时候会去找starter包下resources/META-INF/spring.factories文件，然后根据文件中配置的自动配置类运行，加载autoconfigure类。

2.根据@Conditional注解的条件，决定Bean是否要注入的容器中去。

3.然后我们一般用的就是这个Bean，来使用其中的一些功能。

三、编写自己的Starter

3.1 创建maven项目

首先我们创建一个maven项目，按照如下名字起名，其实starter说白了也只是一个jar：

一般的，官方的starter命名方式是spring-boot-start-xxx的形式，为了区分，我们自定义的starter用xxx-spring-boot-starter的命名方式。

1.添加springboot的依赖，因为要成为一个spring-boot-starter是需要依赖springboot的这套流程的，所以我们引入以下依赖：

<project xmlns='http://maven.apache.org/POM/4.0.0'
         xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
         xsi:schemaLocation='http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd'>
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example.demo</groupId>
    <artifactId>person-spring-boot-starter</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-autoconfigure</artifactId>
            <version>2.0.0.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
            <version>2.0.0.RELEASE</version>
            <optional>true</optional>
        </dependency>
    </dependencies>

</project>

2.添加配置类PersonProperties，主要来从配置文件中读取配置绑定到这个类上：

package com.example.demo;

import org.springframework.boot.context.properties.ConfigurationProperties;

@ConfigurationProperties(prefix = 'spring.person')
public class PersonProperties {
    private  String name;

    private  Integer age;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }
}

3.添加我们的核心服务类，这里边是我们主要提供的功能，假设我们提供了一个sayHello方法，返回一段话：

package com.example.demo;

public class PersonService {
    private PersonProperties personProperties;

    public PersonService(PersonProperties personProperties) {
        this.personProperties = personProperties;
    }
    public String sayHello() {
        return '大家好，我叫: ' + personProperties.getName() + ', 今年' + personProperties.getAge() + '岁';
    }
}

4.添加自动配置类，这个类主要是给springboot来用的，springboot会用这个类来启动，激活我们的服务，注册都容器中去：

@Configuration
@EnableConfigurationProperties(PersonProperties.class)
@ConditionalOnClass(PersonService.class)
@ConditionalOnProperty(prefix = 'spring.person', value = 'enabled', matchIfMissing = true)
public class PersonServiceAutoConfiguration {
    @Autowired
    private  PersonProperties personProperties;

    @Bean
    public  PersonService personService(){
        return new PersonService(personProperties);
    }
}

解释一下代码中用到的几个注解：

• @ConditionalOnClass，当classpath下发现该类的情况下进行自动配置。


• @ConditionalOnMissingBean，当Spring Context中不存在该Bean时。


• @ConditionalOnProperty(prefix = 'srping.person',value = 'enabled',havingValue = 'true')，当配置文件中spring.perons.enabled=true时。如果没有，使用matchIfMissing的值，也为true。


• @Bean，把返回的PersonService对象添加的spring容器中去，这样我们再使用的使用就可以直接装配了。

其他注解：

• @ConditionalOnBean:当容器中有指定的Bean的条件下


• @ConditionalOnClass：当类路径下有指定的类的条件下


• @ConditionalOnExpression:基于SpEL表达式作为判断条件


• @ConditionalOnJava:基于JVM版本作为判断条件


• @ConditionalOnJndi:在JNDI存在的条件下查找指定的位置


• @ConditionalOnMissingBean:当容器中没有指定Bean的情况下


• @ConditionalOnMissingClass:当类路径下没有指定的类的条件下


• @ConditionalOnNotWebApplication:当前项目不是Web项目的条件下


• @ConditionalOnProperty:指定的属性是否有指定的值


• @ConditionalOnResource:类路径下是否有指定的资源


• @ConditionalOnSingleCandidate:当指定的Bean在容器中只有一个，或者在有多个Bean的情况下，用来指定首选的Bean


• @ConditionalOnWebApplication:当前项目是Web项目的条件下

 5. 在resources下添加spring.factories文件，目录结构如下/resources/META-INF/spring.factories，springboot会自动识别这个文件，加载运行我们的PersonServiceAutoConfiguration类。

6.编译运行，用maven install安装jar，默认会安装的maven的仓库里边，用于后来我们使用。

3.2 创建springboot项目测试

这一步简单就不说了，直接按模板创建一个springboot的web项目就行了，然后我们在pom.xml中添加我们刚才写好的person-spring-boot-starter：

 <dependency>
     <groupId>com.example.demo</groupId>
     <artifactId>person-spring-boot-starter</artifactId>
     <version>1.0-SNAPSHOT</version>
 </dependency>

配置文件中添加starter的配置项：

spring.person.age=12
spring.person.name=songlin

添加一个控制器测试：

@RestController
public class HelloController {

    @Autowired
    PersonService personService;

    @GetMapping('/hello')
    public String hello(){
        String s = personService.sayHello();
        return s;
    }
}

访问http://localhost:8080/hello，显示如下：

四、总结

当我们想往springboot集成一个功能的时候，就可以用这种方式了，关于starter的写法，大家还可以参看源码，理解了源码我们就能写出更好用的starter了。springboot的基本入门系列就先到这了，往后我们就开始学习springboot集成高级功能了。