一、简介
mica-auto 是 Spring cloud 微服务框架 Mica 中的一个基础组件，用来生成 Spring boot starter 的一些基础配置。
二、功能
- 生成 spring.factories。
- 生成 spring-devtools.properties
- 生成 FeignClient 到 spring.factories 中，供 mica-cloud 中完成 Feign 自动化配置。
- 生成 java Spi 配置，需要添加 [@AutoService ]() 注解。
| 注解 |
spring.factories 或 Spi key |
| @AutoContextInitializer |
ApplicationContextInitializer |
| @AutoListener |
ApplicationListener |
| @AutoRunListener |
SpringApplicationRunListener |
| @AutoEnvPostProcessor |
EnvironmentPostProcessor |
| @AutoFailureAnalyzer |
FailureAnalyzer |
| @Component |
EnableAutoConfiguration |
| @AutoService |
java Spi 生成配置 |
三、变更记录
- 添加对 spring boot
SpringApplicationRunListener 的支持。
- 添加对 spring boot
EnvironmentPostProcessor 的支持。
- Spring boot 升级到
2.2.6.RELEASE。
四、使用
注意： 如果你项目中使用了 Lombok 请将 mica-auto 的依赖放置到 Lombok 后面。
maven
<dependency>
<groupId>net.dreamlu</groupId>
<artifactId>mica-auto</artifactId>
<version>1.2.1</version>
<scope>provided</scope>
</dependency>
gradle >= 5.x
annotationProcessor("net.dreamlu:mica-auto:1.2.1")
gradle < 5.x
compileOnly "net.dreamlu:mica-auto:1.2.1"
java spi 示例：
- 添加注解
@AutoService 指定 spi 接口 Processor.class。
package foo.bar;
import javax.annotation.processing.Processor;
@AutoService(Processor.class)
public class MyProcessor implements Processor {
// …
}
AutoService 将会自动生成 spi 的配置文件 META-INF/services/javax.annotation.processing.Processor 。内容:
foo.bar.MyProcessor
5、使用场景
- Spring boot starter 开发利器，自动生成 spring.factories、spring-devtools.properties 配置。
- 多模块项目中的子项目，包名不同时的自动配置（主项目不建议添加）。
- java spi 扩展自动生成配置。
建议关注如梦技术码云：https://gitee.com/596392912 ，更多微服务核心组件值得拥有。
