SpringBoot源码学习笔记之自定义boot-starter
1概述
遵循springboot官方建议，对于非官方的starter命名方式为xxx-spring-boot-starter,所以本工程名为hello-spring-boot-starter。
SpringBoot中的starter是一种非常重要的机制，能够抛弃以前繁杂的配置，将其统一集成进starter，应用者只需要在maven中引入starter依赖，SpringBoot就能自动扫描到要加载的信息并启动相应的默认配置。starter让我们摆脱了各种依赖库的处理，需要配置各种信息的困扰。SpringBoot会自动通过classpath路径下的类发现需要的Bean，并注册进IOC容器。
SpringBoot提供了针对日常企业应用研发各种场景的spring-boot-starter依赖模块。所有这些依赖模块都遵循着约定成俗的默认配置，并允许我们调整这些配置，即遵循“约定大于配置”的理念。
1.1原理
我们知道使用一个公用的starter的时候，只需要将相应的依赖添加的Maven的配置文件当中即可，免去了自己需要引用很多依赖类，并且SpringBoot会自动进行类的自动配置。那么 SpringBoot 是如何知道要实例化哪些类，并进行自动配置的呢,分如下三步骤:
-
SpringBoot 在启动时会去依赖的starter包中寻找 resources/META-INF/spring.factories 文件，然后根据文件中配置的Jar包去扫描项目所依赖的Jar包，这类似于 Java 的 SPI 机制。
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.kikop.boot.HelloServiceAutoConfiguration
根据自定义starter中的spring.factories 自动配置类加载AutoConfiguration类。
-
根据 @Conditional注解的条件，判断是否进行自动配置并将Bean实例化注入Spring ApplicationContext 上下文当中。
我们也可以使用@ImportAutoConfiguration({HelloServiceAutoConfiguration.class}) 指定自动配置哪些类。
1.2自定义starter应用
2实现步骤
2.1maven依赖
4.0.0
com.kikop.boot
hello-spring-boot-starter
2.0-SNAPSHOT
jar
org.springframework.boot
spring-boot-configuration-processor
2.1.4.RELEASE
true
org.springframework.boot
spring-boot-autoconfigure
2.1.4.RELEASE
org.springframework.boot
spring-boot-maven-plugin
2.1.4.RELEASE
true
2.2实体类映射配置信息
package com.kikop.mytech.properties;
import org.springframework.boot.context.properties.ConfigurationProperties;
/**
* @author kikop
* @version 1.0
* @project Name: hello-spring-bootstarter
* @file Name: HelloServiceProperties
* @desc 功能描述 实体类映射配置信息
* 对应yml配置文件总的属性,配置此注解可以自动导入application.properties配置文件中的属性
* 它不但能映射成String或基本类型的变量。还可以映射为List，Map等数据结构
* @date 2020/2/20
* @time 7:33
* @by IDE: IntelliJ IDEA
*/
@ConfigurationProperties(prefix = HelloServiceProperties.PREFIX)
public class HelloServiceProperties {
public static final String PREFIX = "mytech.demo";
// 定义jar包中默认的配置属性:name
private String name = "kikop";
// 定义jar包中默认的配置属性:hobby
private String hobby = "run";
// 定义jar包中默认的配置属性:place
private String place = "China";
public String getPlace() {
return place;
}
public void setPlace(String place) {
this.place = place;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getHobby() {
return hobby;
}
public void setHobby(String hobby) {
this.hobby = hobby;
}
}
2.3业务Handler类
package com.kikop.mytech.service;
/**
* @author kikop
* @version 1.0
* @project Name: hello-spring-bootstarter
* @file Name: HelloService
* @desc 功能描述 Starter要实现的功能(已基于业务转化的包装类)
* @date 2020/2/20
* @time 7:36
* @by IDE: IntelliJ IDEA
*/
public class HelloService {
public String strName;
public String strHobby;
public HelloService(String strName, String strHobby) {
this.strName = strName;
this.strHobby = strHobby;
}
public String say() {
return this.strName + "---- " + strHobby;
}
}
2.4自动配置类
package com.kikop.mytech.config;
import com.kikop.mytech.properties.HelloServiceProperties;
import com.kikop.mytech.service.HelloService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* @author kikop
* @version 1.0
* @project Name: hello-spring-bootstarter
* @file Name: HelloServiceAutoConfiguration
* @desc 功能描述 自动配置类,有条件的进行Bean注入
* @date 2020/2/20
* @time 7:37
* @by IDE: IntelliJ IDEA
*/
// 1.Configuration 表明此类是一个配置类，定义beans,被spring进行管理
@Configuration
// 2.启用属性配置，将读取 HelloServiceProperties 里面的属性
@EnableConfigurationProperties(HelloServiceProperties.class)
// 3.当类路径下面有 HelloServiceInfo类时，自动配置
@ConditionalOnClass(HelloService.class)
// 4.判断指定的属性是否具备指定的值(放类上)
//@ConditionalOnProperty(prefix = HelloServiceProperties.PREFIX, value = "enabled", matchIfMissing = true)
public class HelloServiceAutoConfiguration {
/**
* 注入配置
*/
@Autowired
private HelloServiceProperties helloServiceProperties;
/**
* 注入Bean(已基于业务转化的类)
*
* @return
*/
@Bean
@ConditionalOnMissingBean(HelloService.class)
// 4.判断指定的属性是否具备指定的值(放Bean上)
// 当配置文件中 mytech.demo.enabled=true
// @ConditionalOnProperty(prefix = HelloServiceProperties.PREFIX, value = "enabled", matchIfMissing = true)
public HelloService helloServiceInfo() {
HelloService helloService = new HelloService(helloServiceProperties.getName(),
helloServiceProperties.getHobby());
return helloService;
}
}
2.4spring.factories
// 文件位置:resources/META-INF/spring.factories
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.kikop.mytech.config.HelloServiceAutoConfiguration
3测试
3.1maven依赖
com.kikop.boot
hello-spring-boot-starter
2.0-SNAPSHOT
3.2测试类
package com.kikop.demo;
import com.kikop.mytech.service.HelloService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@SpringBootApplication
public class DemoApplication {
@Autowired
private HelloService helloService;
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
@RequestMapping("/say")
public String say() {
return helloService.say();
}
}
3.3配置
// resources\application.properties
mytech.demo.name=kikop
mytech.demo.hobby=swim
参考
1.SpringBoot应用篇（一）：自定义starter
https://www.cnblogs.com/hello-shf/p/10864977.html