Skip to content

dousp/starter-demo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

自定义spring boot starter

  • 具体细节请参考官网,或其他教程

一个完整的Spring Boot Starter可能包含以下组件:

  • autoconfigure模块:包含自动配置的代码
  • starter模块:提供对autoconfigure模块的依赖,以及一些其它的依赖
    PS:如果你不需要区分这两个概念的话,也可以将自动配置代码模块与依赖管理模块合并成一个模块
    PS:本例子合并成了一个模块

autoconfigure模块

  • 建议在autoconfigure模块中包含下列依赖:
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-autoconfigure-processor</artifactId>
        <optional>true</optional>
    </dependency>

starter模块

  • starter是一个空jar。它唯一的目的是提供这个库所必须的依赖。
  • 你的starter必须直接或间接引用核心的Spring Boot starter(spring-boot-starter)

starter创建步骤

  1. 实现XxxxxxAutoConfiguration.class类,里面配置了starter默认自动使用的配置,并加上@Conditional限制条件.这需要实现需要自动装载的bean;
  2. 限制Auto-Configuration的顺序,使用 @AutoConfigureAfter or @AutoConfigureBefore可以限制XxxxxxAutoConfiguration.class的加载顺序;
  3. 在META-INF/spring.factories里面加上如下:
       # 如果有多个XxxxxAutoConfiguration,用逗号分隔
       org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
          com.example.starter.XxxxxxAutoConfiguration
    
  4. 创建metadata,在目录META-INF/spring-configuration-metadata.json下,作用:
    • XxxxxxAutoConfiguration需要用到的一些properties的,这些properties我们可以写在application.properties里面,然后通过这个文件的规约给出提示,或者对应的properties类上要有注释;
    • 这个xx-metadata.json文件(由spring-boot-autoconfigure-processor)生成在 target/classes/META-INF/spring-configuration-metadata.json;
    • 同时,IDEA中检查下:Preferences->Build, Execution, Deployment->Compile->Annotation Processors->Enable annonation processing
    • mvn clean install后需要copy到xxx-Starter项目的 resources/META-INF/ 目录下
  5. 创建starter,其实对于每个starter里面并没有源码,只是依赖了一个对应的autoconfiguration;

注意

  1. 在其他项目pom文件中引入我们新创建的starter依赖后,Class import不了,提示 Cannot resolve symbol 'packageName'
    • 这时候要检查我们starter中,是否删除pom文件中的spring-boot-maven-plugin插件
    • 因为starter生成的jar与可执行jar的目录是有区别的

测试使用

pom

    <dependency>
        <groupId>com.example</groupId>
        <artifactId>starter-demo</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </dependency>

controller

    @RestController
    @RequestMapping("/say")
    public class SayController {
    
        @Resource
        public com.example.starter.demo.service.StartDemoService startDemoService;
    
        @GetMapping("/{name}")
        public String hello(@PathVariable("name") String name) {
            return startDemoService.sayHello(name);
        }
    
        @GetMapping("/info")
        public String info() {
            return startDemoService.helloWorld();
        }
    }

About

自定义springboot starter

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages