【黑科技】mica-auto 2.0.3发布增强 spring boot 2.4 的支持

如梦技术
569 阅读1分钟

一、简介

mica-auto （Spring boot stater开发利器）是 Spring cloud 微服务框架 Mica 中的一个基础组件，用来生成 Spring boot starter 的一些基础配置。

二、原理

mica auto 采用 Annotation Processor，她不是什么新技术，在 jdk 1.6 就存在了。 Annotation Processor 是 javac 的一个工具，它用来在编译时扫描和处理注解。通过 Annotation Processor 可以获取到注解和被注解对象的相关信息，然后根据注解自动生成Java代码，省去了手动编写，提高了编码效率。大名鼎鼎的 Lombok 也是采用的该技术。

三、功能

  • 自动生成 spring.factories、spring-devtools.properties 配置（Spring boot starter 开发利器）。
  • 生成 FeignClient 到 spring.factories 中，供 mica-cloud 中完成 Feign 自动化配置。
  • 生成 java spi 配置，需要添加 @AutoService 注解。
注解spring.factories 或 Spi key
@AutoContextInitializerApplicationContextInitializer
@AutoListenerApplicationListener
@AutoRunListenerSpringApplicationRunListener
@AutoEnvPostProcessorEnvironmentPostProcessor
@AutoFailureAnalyzerFailureAnalyzer
@AutoConfigImportFilterAutoConfigurationImportFilter
@AutoTemplateProviderTemplateAvailabilityProvider
@AutoEnableCircuitBreakerEnableCircuitBreaker
@AutoConfigDataLocationResolverConfigDataLocationResolver
@AutoConfigDataLoaderConfigDataLoader
@ComponentEnableAutoConfiguration
@AutoIgnore忽略，不生成到 spring.factories
@AutoService生成 java spi 配置

四、2.x 更新记录

  • 添加 AutoConfigDataLocationResolver。
  • 添加 AutoConfigDataLoader。
  • 添加 AutoEnableCircuitBreaker。
  • 升级 spring boot 到 2.4.1（非强制依赖，无兼容性问题）。

五、使用

注意： 如果你项目中使用了 Lombok 请将 mica-auto 的依赖放置到 Lombok 后面。

5.1 maven

<dependency>
  <groupId>net.dreamlu</groupId>
  <artifactId>mica-auto</artifactId>
  <version>2.0.3</version>
  <scope>provided</scope>
</dependency>

5.2 gradle >= 5.x

annotationProcessor("net.dreamlu:mica-auto:2.0.3")

5.3 gradle < 5.x

compileOnly "net.dreamlu:mica-auto:2.0.3"

5.4 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

六、mica 生态

avatar
文章
阅读
粉丝