Skip to content

Latest commit

 

History

History
115 lines (87 loc) · 6.1 KB

README.md

File metadata and controls

115 lines (87 loc) · 6.1 KB
Raw

mica-auto SPI、Spring boot starter 利器

Java CI JAVA 8 mica-auto Maven Codacy Badge

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

✨✨✨推广：BladeX 物联网平台✨✨✨iot.bladex.cn

简体中文 | English | 版本更新记录

版本说明

version spring boot version java version
3.1.4 3.x 17
2.3.5 1.x ~ 3.x 1.8

原理

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

使用场景

主要是用来避免 Spring boot 主项目包同 子项目或者子模块 包不一致，避免包扫描不到的问题。

  • 自定义 spring boot starter。
  • 多模块项目中的子项目（不建议主项目添加 mica-auto）。

功能

  • 自动生成 spring.factories、spring-devtools.properties 配置（Spring boot starter 开发利器）。
  • 生成 FeignClient 到 spring.factories 中，供 mica-cloud 中完成 Feign 自动化配置。
  • 生成 java spi 配置，需要添加 @AutoService 注解。
注解 spring.factories 或 Spi key
@AutoContextInitializer ApplicationContextInitializer
@AutoListener ApplicationListener
@AutoRunListener SpringApplicationRunListener
@AutoEnvPostProcessor EnvironmentPostProcessor
@AutoFailureAnalyzer FailureAnalyzer
@AutoConfigImportFilter AutoConfigurationImportFilter
@AutoTemplateProvider TemplateAvailabilityProvider
@AutoEnableCircuitBreaker EnableCircuitBreaker
@AutoConfigDataLocationResolver ConfigDataLocationResolver
@AutoConfigDataLoader ConfigDataLoader
@AutoDatabaseInitializerDetector DatabaseInitializerDetector
@AutoDependsOnDatabaseInitializationDetector DependsOnDatabaseInitializationDetector
@Component EnableAutoConfiguration
@AutoIgnore 忽略，不生成到 spring.factories
@AutoService java Spi 生成配置
注解 aot.factories
@AotRuntimeHintsRegistrar RuntimeHintsRegistrar
@AotBeanRegistration BeanRegistrationAotProcessor
@AotBeanFactoryInitialization BeanFactoryInitializationAotProcessor

使用

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

maven

<dependency>
  <groupId>net.dreamlu</groupId>
  <artifactId>mica-auto</artifactId>
  <version>${mica-auto.version}</version>
  <scope>provided</scope>
</dependency>

gradle >= 5.x

annotationProcessor("net.dreamlu:mica-auto:$micaAutoVersion}")

gradle < 5.x

compileOnly "net.dreamlu:mica-auto:$micaAutoVersion"

原理

扫描 @Component，自动生成相应的配置，支持组合注解。

mica 生态

开源协议

LGPL（GNU Lesser General Public License）

LGPL是GPL的一个为主要为类库使用设计的开源协议。和GPL要求任何使用/修改/衍生之GPL类库的的软件必须采用GPL协议不同。LGPL允许商业软件通过类库引用(link)方式使用LGPL类库而不需要开源商业软件的代码。这使得采用LGPL协议的开源代码可以被商业软件作为类库引用并发布和销售。

但是如果修改LGPL协议的代码或者衍生，则所有修改的代码，涉及修改部分的额外代码和衍生的代码都必须采用LGPL协议。因此LGPL协议的开源代码很适合作为第三方类库被商业软件引用，但不适合希望以LGPL协议代码为基础，通过修改和衍生的方式做二次开发的商业软件采用。

用户权益

  • 允许以引入不改源码的形式免费用于学习、毕设、公司项目、私活等。
  • 特殊情况修改代码，但仍然想闭源需经过作者同意。
  • 参考请注明：参考 mica-auto: https://github.com/lets-mica/mica-auto

参考

Google Auto: https://github.com/google/auto

Spring 5 - spring-context-indexer: https://github.com/spring-projects/spring-framework/tree/main/spring-context-indexer

微信公众号

如梦技术

JAVA架构日记，精彩内容每日推荐！