一、关于Starter
1.1、是什么
Starter是Spring Boot中的一个非常重要的概念，Starter相当于模块，它能将模块所需的依赖整合起来并对模块内的Bean根据环境（ 条件）进行自动配置。
使用者只需要依赖相应功能的Starter，无需做过多的配置和依赖，Spring Boot就能自动扫描并加载相应的模块并设置默认值，做到开箱即用。
1.2、Springboot 自动配置
SpringBoot中的starter是一种非常重要的机制，能够抛弃以前繁杂的配置，将其统一集成进starter，应用者只需要在maven中引入starter依赖，Spring Boot就能自动扫描各个jar包下classpath路径的spring.factories文件，加载自动配置类信息，加载相应的bean信息并启动相应的默认配置。
Spring Boot提供了针对日常企业应用研发各种场景的spring-boot-starter依赖模块。所有这些依赖模块都遵循着约定成俗的默认配置，并允许我们调整这些配置，即遵循“约定大于配置”的理念。
1.3、spring.factories
Spring Boot会默认扫描跟启动类平级的包，如果我们的Starter跟启动类不在同一个主包下，需要通过配置spring.factories文件来配置生效，SpringBoot默认加载各个jar包下classpath路径的spring.factories文件，配置的key为：
org.springframework.boot.autoconfigure.EnableAutoConfiguration
1.4、Starter开发常用注解
SpringBoot经过查找spring.factories文件，加载自动配置类，而自动配置类中定义了各种运行时判断条件，如@ConditionalOnMissingBean(A.class)等，只要ioc容器中没有指定的A类型的bean信息，该配置文件才会生效。
@Conditional是Spring4新提供的注解，它的作用是按照一定的条件进行判断，满足条件给容器注册bean。
属性映射注解：
@ConfigurationProperties ：配置文件属性值和实体类的映射
@EnableConfigurationProperties : 和 @ConfigurationProperties 配合使用，把 @ConfigurationProperties 修饰的类加入ioc容器。
配置bean注解：
@Configuration : 标识该类为配置类，并把该类注入ioc容器
@Bean : 一般在方法上使用，声明一个bean，bean名称默认是方法名称，类型为返回值。
条件注解：
@Conditional 是根据条件类创建特定的Bean，条件类需要实现Condition接口，并重写matches接口来构造判断条件。
@ConditionalOnBean 容器中存在指定bean，才会实例化一个Bean
@ConditionalOnMissingBean 容器中不存在指定bean，才会实例化一个Bean
@ConditionalOnClass 系统中有指定类，才会实例化一个Bean
@ConditionalOnMissingClass 系统中没有指定类，才会实例化一个Bean
@ConditionalOnExpression 当SpEl表达式为true的时候，才会实例化一个Bean
@AutoConfigureAfter 在某个bean完成自动配置后实例化这个bean
@AutoConfigureBefore 在某个bean完成自动配置前实例化这个bean
@ConditionalOnJava 系统中版本是否符合要求
@ConditionalOnSingleCandidate 当指定的Bean在容器中只有一个，或者有多个但是指定了首选的Bean时触发实例化
@ConditionalOnResource 类路径下是否存在指定资源文件
@ConditionalOnWebApplication 是web应用
@ConditionalOnNotWebApplication 不是web应用
@ConditionalOnJndi JNDI指定存在项
@ConditionalOnProperty 配置Configuration的加载规则
prefix 配置属性名称的前缀
value 数组，获取对应property名称的值，与name不可同时使用
name 数组，可与prefix组合使用，组成完整的配置属性名称，与value不可同时使用
havingValue 比较获取到的属性值与havingValue给定的值是否相同，相同才加载配置
matchIfMissing 缺少该配置属性时是否可以加载。如果为true，没有该配置属性时也会正常加载；反之则不会生效
1.5、Full全模式和Lite轻量级模式
@Configuration参数proxyBeanMethods：
1、Full 全模式（默认）：@Configuration(proxyBeanMethods = true)
同一配置类下，当直接调用@Bean修饰的方法注入的对象，则调用该方法会被代理，从ioc容器中取bean实列，所以实列是一样的。即单实例对象，在该模式下SpringBoot每次启动都会判断检查容器中是否存在该组件。
2、Lite 轻量级模式：@Configuration(proxyBeanMethods = false)
同一配置类下，当直接调用@Bean修饰的方法注入的对象，则调用该方法不会被代理，相当于直接调用一个普通方法，会有构造方法，但是没有bean的生命周期，返回的是不同的实例。
注：proxyBeanMethods 是为了让使用@Bean注解的方法被代理。而不是@Bean的单例多例的设置参数。
@Configuration(proxyBeanMethods = false)
public class AppConfig {
//放一份myBean到ioc容器
@Bean
public Mybean myBean() {
return new Mybean();
}
//放一份yourBean到ioc容器
@Bean
public YourBean yourBean() {
System.out.println("==========");
//注意：@Configuration(proxyBeanMethods = false)：myBean()方法不代理，直接调用
//注意：@Configuration(proxyBeanMethods = true)：myBean()方法代理，从ioc容器拿
return new YourBean(myBean());
}
}
什么时候用Full全模式，什么时候用Lite轻量级模式？
当在你的同一个Configuration配置类中，注入到容器中的bean实例之间有依赖关系时，建议使用Full全模式。
当在你的同一个Configuration配置类中，注入到容器中的bean实例之间没有依赖关系时，建议使用Lite轻量级模式，以提高springboot的启动速度和性能。
1.6、Starter命名规范
Spring官方Starter通常命名为spring-boot-starter-{name} 如：spring-boot-starter-web
Spring官方建议非官方Starter命名应遵循{name}-spring-boot-starter的格式：如mybatis-spring-boot-starter。
二、开发Starter
1、创建Starter项目
新建项目后，要删除main启动类。
2、添加依赖
<?xml version="1.0" encoding="UTF-8"?>
<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">
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.6.1</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<modelVersion>4.0.0</modelVersion>
<groupId>com.payn</groupId>
<artifactId>payn-spring-boot-starter</artifactId>
<version>1.0</version>
<properties>
<java.version>1.8</java.version>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<!--包含自动配置的代码-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-autoconfigure</artifactId>
</dependency>
<!--配置文件点击可以跳转实体-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-configuration-processor</artifactId>
<optional>true</optional>
</dependency>
</dependencies>
</project>
我们没有main入口，需要去除pom文件中maven打包插件spring-boot-maven-plugin。
spring-boot-configuration-processor作用：
- spring-boot-configuration-processor其实是一个注解处理器，在编译阶段干活的，一般在maven的声明都是optional 为true。
- 你在idea里面可以点击port，进到这个字段里面，还可以看到配置的提示信息。
- 这是因为在你的资源文件里面有一个spring-configuration-metadata.json文件，这是spring配置的元数据，是json形式。
3、编写属性类
@ConfigurationProperties可以定义一个配置信息类，和配置文件进行映射。
@ConfigurationProperties(prefix = "payn.config")
public class HelloProperties {
private String name = "hello 默认值！";
private int age = 8;
4、自定义业务类
这里可以模拟一些获取了配置文件信息的进行业务操作的业务类。
public class HelloService {
private String name;
private int age;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String hello() {
return "HelloService{" +
"name='" + name + ''' +
", age=" + age +
'}';
}
}
5、编写自动配置类
命名规范：XxxAutoConfiguration。
@Configuration(proxyBeanMethods = false)
// 当存在某个类时，此自动配置类才会生效
@ConditionalOnClass(value = {HelloService.class})
// 导入我们自定义的配置类,供当前类使用
@EnableConfigurationProperties(value = HelloProperties.class)
// 只有非web应用程序时此自动配置类才会生效
@ConditionalOnWebApplication
//判断payn.config.flag的值是否为“true”， matchIfMissing = true：没有该配置属性时也会正常加载
@ConditionalOnProperty(prefix = "payn.config", name = "flag", havingValue = "true", matchIfMissing = true)
public class HelloAutoConfiguration {
/**
* @param helloProperties 直接方法签名入参注入HelloProperties,也可以使用属性注入
* @return
*/
@Bean
@ConditionalOnMissingBean(HelloService.class)
//@ConditionalOnProperty(prefix = "ljw.config", name = "flag", havingValue = "true", matchIfMissing = true)
public HelloService helloService(HelloProperties helloProperties) {
HelloService helloService = new HelloService();
//把获取的信息注入
helloService.setName(helloProperties.getName());
helloService.setAge(helloProperties.getAge());
return helloService;
}
}
注：这里配置一个web应用才能注入，并且payn.config.flag的值是否为“true”或者不配置该key才能注入HelloService服务。
6、编写spring.factories
把自动配置类HelloAutoConfiguration配置到
org.springframework.boot.autoconfigure.EnableAutoConfiguration的key
下，springboot会自动加载该文件并根据条件装配。
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.payn.starter.config.HelloAutoConfiguration
7、编写配置提示文件（非必须）
additional-spring-configuration-metadata.json
配置additional-spring-configuration-metadata.json文件后，在开发人员的IDE工具使用个人编写的配置读取很有效的在application.properties或application.yml文件下完成提示。
{"properties": [
{
"name": "ljw.config.name",
"type": "java.lang.String",
"defaultValue": "hello 默认值！这里配置的是提示，真正默认值在Properties里面",
"description": "这是字符串名称啊."
},
{
"name": "ljw.config.age",
"defaultValue": 8,
"description": "这是int类型的年龄啊.",
"deprecation": {
"reason": "过时原因.",
"replacement": "替代key是：ljw.config.age22",
"level": "warning"
}
}
]}
参考下面properties表格进行配置上的理解。
名称 类型 目的
name String 属性的全名。名称采用小写的周期分隔形式(例如server.address)。此属性是强制性的。
type String 属性的数据类型的完整签名（例如java.lang.String），但也是完整的泛型类型（例如java.util.Map<java.util.String,acme.MyEnum>）。您可以使用此属性来指导用户可以输入的值的类型。为了保持一致性，通过使用其包装对应项（例如，boolean变为java.lang.Boolean）来指定基元的类型。请注意，此类可能是一个复杂类型，它从Stringas绑定的值转换而来。如果类型未知或基本类型，则可以省略。
description String 可以向用户显示的组的简短描述。如果没有可用的描述，则可以省略。建议描述为简短段落，第一行提供简明摘要。描述中的最后一行应以句点（.）结尾。
sourceType String 贡献此属性的源的类名称。例如，如果属性来自带注释的类@ConfigurationProperties，则此属性将包含该类的完全限定名称。如果源类型未知，则可以省略。
defaultValue Object 默认值，如果未指定属性，则使用该值。如果属性的类型是数组，则它可以是值数组。如果默认值未知，则可以省略。
deprecation 数组 过时的描述。
deprecation每个properties元素的属性中包含的JSON对象可以包含以下属性：
名称 类型 目的
level String 弃用级别，可以是warning（默认）或error。当属性具有warning弃用级别时，它仍应绑定在环境中。但是，当它具有error弃用级别时，该属性不再受管理且不受约束。
reason String 该属性被弃用的原因的简短描述。如果没有可用的原因，可以省略。建议描述为简短段落，第一行提供简明摘要。描述中的最后一行应以句点（.）结尾。
replacement String 替换此不推荐使用的属性的属性的全名。如果此属性没有替换，则可以省略。
spring-configuration-metadata.json
spring-configuration-metadata.json代码量挺大的，为了方便我们可以通过IDE来生成，这里使用的是idea。
在idea设置中搜索Annotation Processors，接下来勾住Enable annonation processing就完成了。 在编译打包后的文件中看到自动生成的spring-configuration-metadata.json。这个文件不用我们编写。
下面是自动生成的：
{
"groups": [
{
"name": "test.config",
"type": "com.test.starter.properties.HelloProperties",
"sourceType": "com.test.starter.properties.HelloProperties"
}
],
"properties": [
{
"name": "test.config.age",
"type": "java.lang.Integer",
"sourceType": "com.test.starter.properties.HelloProperties",
"defaultValue": 8
},
{
"name": "test.config.name",
"type": "java.lang.String",
"sourceType": "com.test.starter.properties.HelloProperties",
"defaultValue": "hello 默认值！"
}
],
"hints": []
}
三、测试Starter
1、前置环境
install打包自定义starter项目：payn-spring-boot-starter。
新建项目：payn-test-spring-boot-starter。
2、添加依赖
引入打好包的自定义starter。
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<!--测试web应用-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!--自定义satrter-->
<dependency>
<groupId>com.test</groupId>
<artifactId>payn-spring-boot-starter</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
</dependencies>
3、测试类
@Service
public class TestController implements CommandLineRunner {
/**
* 注入自定义starter服务
*/
@Resource
private HelloService helloService;
@Override
public void run(String... args) throws Exception {
System.out.println(helloService.hello());
}
}
4、修改配置文件
输入前缀可以看出已经有提示了
test.config.name=payn hello!
test.config.age=99
test.config.flag=true
#不会注入
#test.config.flag=true1
# 可以看到哪些自动配置了
debug=true
5、运行程序打印
HelloService{name='payn hello!', age=99}
条件注入：
如果没有spring-boot-starter-web依赖，不能注入服务HelloService。
如果配置了payn.config.flag，值不是true，不能注入服务HelloService；如果不配置payn.config.flag，可以注入。
6、查看自动配置类生效的方法
查看自动配置类生效的方法：
通过启用 debug=true 属性，让控制台打印自动配置报告，这样就可以很方便地知道哪些自动配置类生效。
HelloAutoConfiguration matched:
- @ConditionalOnClass found required class 'com.payn.starter.service.HelloService' (OnClassCondition)
- @ConditionalOnWebApplication (required) found 'session' scope (OnWebApplicationCondition)
- @ConditionalOnProperty (ljw.config.flag=true) matched (OnPropertyCondition)
HelloAutoConfiguration#helloService matched:
- @ConditionalOnMissingBean (types: com.payn.starter.service.HelloService; SearchStrategy: all) did not find a
评论