SpringBoot--自定义SpringBootStarter

怼烎@ 2022-12-09 02:50 67阅读 0赞

原文网址：[SpringBoot--自定义SpringBootStarter\_IT利刃出鞘的博客-CSDN博客][SpringBoot--_SpringBootStarter_IT_-CSDN]

# 其他网址 #

# 简介 #

**其他网址**

> [Spring Boot Starters是什么？ - 一步一个小脚印 - 博客园][Spring Boot Starters_ - _ -]

**starter的作用**

> starter是SpringBoot中的一个新发明，它有效的降低了项目开发过程的复杂程度，对于简化开发操作有着非常好的效果。本文转载了一片文章，详细介绍了spring boot stater是什么？它的作用是什么？
> 
> 　　Spring Boot Starter是在SpringBoot组件中被提出来的一种概念，stackoverflow上面已经有人概括了这个starter是什么东西：[java - What are \`spring-boot-starter\` jars? - Stack Overflow][java - What are _spring-boot-starter_ jars_ - Stack Overflow]
> 
> 大概意思就是说starter是一种对依赖的synthesize（合成）。其内容如下：
> 
> Starter POMs are a set of convenient dependency descriptors that you can include in your application. You get a one-stop-shop for all the Spring and related technology that you need, without having to hunt through sample code and copy paste loads of dependency descriptors. For example, if you want to get started using Spring and JPA for database access, just include the spring-boot-starter-data-jpa dependency in your project, and you are good to go.

**没有starter时的操作**

> 在没有starter之前，假如我想要在Spring中使用jpa，那我可能需要做以下操作：
> 
> 1.  在Maven中引入使用的数据库的依赖（即JDBC的jar）
> 2.  引入jpa的依赖
> 3.  在xxx.xml中配置一些属性信息
> 4.  反复的调试直到可以正常运行
> 
> 　　需要注意的是，这里操作在我们**每次新建一个需要用到jpa的项目的时候都需要重复的做一次**。也许你在第一次自己建立项目的时候是在Google上自己搜索了一番，花了半天时间解决掉了各种奇怪的问题之后，jpa终于能正常运行了。有些有经验的人会在OneNote上面把这次建立项目的过程给记录下来，包括操作的步骤以及需要用到的配置文件的内容，在下一次再创建jpa项目的时候，就不需要再次去Google了，只需要照着笔记来，之后再把所有的配置文件copy&paste就可以了。
> 
> 　　像上面这样的操作也不算不行，事实上我们在没有starter之前都是这么干的，但是这样做有几个问题：
> 
> 1.  如果过程比较繁琐，这样一步步操作会增加出错的可能性
> 2.  不停地copy&paste不符合[Don’t repeat yourself][Don_t repeat yourself]精神
> 3.  在第一次配置的时候（尤其如果开发者比较小白），需要花费掉大量的时间

**starter的逻辑**

> starter的主要目的就是为了解决上面的这些问题。
> 
> 　　starter的理念：starter会把所有用到的依赖都给包含进来，避免了开发者自己去引入依赖所带来的麻烦。需要注意的是不同的starter是为了解决不同的依赖，所以它们内部的实现可能会有很大的差异，例如jpa的starter和Redis的starter可能实现就不一样，这是因为starter的本质在于synthesize，这是一层在逻辑层面的抽象，也许这种理念有点类似于Docker，因为它们都是在做一个“包装”的操作，如果你知道Docker是为了解决什么问题的，也许你可以用Docker和starter做一个类比。
> 
> 　　starter的实现：虽然不同的starter实现起来各有差异，但是他们基本上都会使用到两个相同的内容：ConfigurationProperties和AutoConfiguration。因为Spring Boot坚信“约定大于配置”这一理念，所以我们使用ConfigurationProperties来保存我们的配置，并且这些配置都可以有一个默认值，即在我们没有主动覆写原始配置的情况下，默认值就会生效，这在很多情况下是非常有用的。除此之外，starter的ConfigurationProperties还使得所有的配置属性被聚集到一个文件中（一般在resources目录下的application.properties），这样我们就告别了Spring项目中XML地狱。
> 
> starter的整体逻辑：
> 
> ![84b993abf4149edcfd73c22125dcbb93.png][]
> 
> 上面的starter依赖的jar和我们自己手动配置的时候依赖的jar并没有什么不同，所以我们可以认为starter其实是把这一些繁琐的配置操作交给了自己，而把简单交给了用户。除了帮助用户去除了繁琐的构建操作，在“约定大于配置”的理念下，ConfigurationProperties还帮助用户减少了无谓的配置操作。并且因为 application.properties 文件的存在，即使需要自定义配置，所有的配置也只需要在一个文件中进行，使用起来非常方便。
> 
> 　　了解了starter其实就是帮助用户简化了配置的操作之后，要理解starter和被配置了starter的组件之间并不是竞争关系，而是辅助关系，即我们可以给一个组件创建一个starter来让最终用户在使用这个组件的时候更加的简单方便。基于这种理念，我们可以给任意一个现有的组件创建一个starter来让别人在使用这个组件的时候更加的简单方便，事实上Spring Boot团队已经帮助现有大部分的流行的组件创建好了它们的starter，你可以在[这里][Link 1]查看这些starter的列表。

**Starter流程概述**

> 1.  Spring Boot在启动时扫描项目所依赖的JAR包，寻找包含spring.factories文件的JAR包
> 2.  根据spring.factories配置加载AutoConfigure类
> 3.  根据 @Conditional 注解的条件，进行自动配置并将Bean注入Spring Context

# 实战 #

## 生成starter ##

**其他网址**

> [快速开发一个自定义 Spring Boot Starter，并使用它。 - 后端][Spring Boot Starter_ -]  
> [SpringBoot系列 - 自己写starter | 飞污熊博客][SpringBoot_ - _starter _]

**目标**

> 需求：提供一个Service，包含一个能够将字符串加上前后缀的方法String wrap(String word)。

**依赖**

>     <?xml version="1.0" encoding="UTF-8"?>
>     <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
>              xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
>         <modelVersion>4.0.0</modelVersion>
>         <parent>
>             <groupId>org.springframework.boot</groupId>
>             <artifactId>spring-boot-starter-parent</artifactId>
>             <version>2.3.0.RELEASE</version>
>             <relativePath/> 
>         </parent>
>         <groupId>com.example</groupId>
>         <artifactId>example-spring-boot-starter</artifactId>
>         <version>0.0.1-SNAPSHOT</version>
>         <name>starter</name>
>         <description>Demo project for Spring Boot</description>
>     
>         <properties>
>             <java.version>1.8</java.version>
>         </properties>
>     
>         <dependencies>
>             <dependency>
>                 <groupId>org.springframework.boot</groupId>
>                 <artifactId>spring-boot-autoconfigure</artifactId>
>             </dependency>
>             <dependency>
>                 <groupId> org.springframework.boot </groupId>
>                 <artifactId> spring-boot-configuration-processor </artifactId>
>                 <optional> true </optional>
>             </dependency>
>             <dependency>
>                 <groupId>org.springframework.boot</groupId>
>                 <artifactId>spring-boot-starter-web</artifactId>
>             </dependency>
>         </dependencies>
>     </project>

>  *  artifactId的命名：Spring 官方 Starter通常命名为spring-boot-starter-\{name\}如 spring-boot-starter-web， [Spring官方建议][Spring]非官方Starter命名应遵循\{name\}-spring-boot-starter的格式。
>  *  spring-boot-autoconfigure：必须引入的包
>  *  spring-boot-configuration-processor：非必须的包。本包作用：
>     
>      *  支持@ConfigurationProperties
>      *  编译时生成spring-configuration-metadata.json，此文件主要给IDE使用，用于提示使用。如在intellij idea中，当配置此jar相关配置属性在application.yml， 你可以用ctlr+鼠标左键，IDE会跳转到你配置此属性的类中
>  *  spring-boot-starter-web:非必须的包。本处仅用来测试starter引入包之后，依赖此starter的工程无需引入。按理starter中不应该再次引入starter

**服务类**

>     package com.example.starter;
>     
>     public class ExampleService {
>         private String prefix;
>         private String suffix;
>     
>         public ExampleService(String prefix, String suffix) {
>             this.prefix = prefix;
>             this.suffix = suffix;
>         }
>         public String wrap(String word) {
>             return prefix + word + suffix;
>         }
>     }

**属性类**

> 前缀、后缀通过读取application.properties(yml)内的参数获得

>     package com.example.starter;
>     
>     import org.springframework.boot.context.properties.ConfigurationProperties;
>     
>     @ConfigurationProperties("example.service")
>     public class ExampleServiceProperties {
>         private String prefix;
>         private String suffix;
>     
>         public String getPrefix() {
>             return prefix;
>         }
>     
>         public void setPrefix(String prefix) {
>             this.prefix = prefix;
>         }
>     
>         public String getSuffix() {
>             return suffix;
>         }
>     
>         public void setSuffix(String suffix) {
>             this.suffix = suffix;
>         }
>     }

**配置类**

>     package com.example.starter;
>     
>     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;
>     
>     @Configuration
>     @ConditionalOnClass(ExampleService.class)
>     @EnableConfigurationProperties(ExampleServiceProperties.class)
>     public class ExampleAutoConfigure {
>         @Autowired
>         private ExampleServiceProperties properties;
>     
>         @Bean
>         @ConditionalOnMissingBean
>         @ConditionalOnProperty(prefix = "example.service",value = "enabled",havingValue = "true")
>         ExampleService exampleService (){
>             return  new ExampleService(properties.getPrefix(),properties.getSuffix());
>         }
>     }
> 
>  *  @ConditionalOnClass，当classpath下发现该类的情况下进行自动配置。
>  *  @ConditionalOnMissingBean，当Spring Context中不存在该Bean时。
>  *  @ConditionalOnProperty(prefix = "example.service",value = "enabled",havingValue = "true")，当配置文件中example.service.enabled=true时。
> 
> 更多相关注解，建议阅读[官方文档该部分][Link 2]。

**添加spring.factories**

> 在resources/META-INF/下创建spring.factories文件，内容如下
> 
>     org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.example.starter.ExampleAutoConfigure
> 
> 如果有多个自动配置类，用逗号分隔换行即可。

**打包安装**

> 运行 mvn:install 打包安装

## 使用starter ##

**依赖**

> 只引入这一个即可

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

**application.yml**

>     example:
>       service:
>         enabled: true
>         prefix: '####'
>         suffix: '@@@@'

**controller**

>     package com.example.controller;
>     
>     import com.example.starter.ExampleService;
>     import org.springframework.beans.factory.annotation.Autowired;
>     import org.springframework.web.bind.annotation.RequestMapping;
>     import org.springframework.web.bind.annotation.RestController;
>     
>     @RestController
>     @RequestMapping("/hello")
>     public class HelloController {
>         @Autowired
>         ExampleService exampleService;
>     
>         @RequestMapping("/test1")
>         public String test1() {
>             return exampleService.wrap("hello");
>         }
>     }

**测试**

> postman访问：[http://localhost:8080/hello/test1][http_localhost_8080_hello_test1]
> 
> 结果：
> 
> ![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ZlaXlpbmcwY2FuZ2xhbmc_size_16_color_FFFFFF_t_70][]

[SpringBoot--_SpringBootStarter_IT_-CSDN]: https://knife.blog.csdn.net/article/details/108714044
[Spring Boot Starters_ - _ -]: https://www.cnblogs.com/tjudzj/p/8758391.html
[java - What are _spring-boot-starter_ jars_ - Stack Overflow]: https://stackoverflow.com/questions/28273543/what-are-spring-boot-starter-jars/28273660#28273660
[Don_t repeat yourself]: https://en.wikipedia.org/wiki/Don%27t_repeat_yourself
[84b993abf4149edcfd73c22125dcbb93.png]: /images/20221123/c86162c0d2234cf1a4abfdbd4ebeb223.png
[Link 1]: https://github.com/spring-projects/spring-boot/tree/v1.5.7.RELEASE/spring-boot-starters
[Spring Boot Starter_ -]: https://juejin.im/entry/6844903471066398733
[SpringBoot_ - _starter _]: https://www.xncoding.com/2017/07/22/spring/sb-starter.html
[Spring]: https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#boot-features-custom-starter-naming
[Link 2]: http://docs.spring.io/spring-boot/docs/1.5.2.RELEASE/reference/htmlsingle/#boot-features-bean-conditions
[http_localhost_8080_hello_test1]: http://localhost:8080/hello/test1
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2ZlaXlpbmcwY2FuZ2xhbmc_size_16_color_FFFFFF_t_70]: /images/20221123/ec38cfba06814981aa71822e19305e48.png