Java SpringBoot自定义starter详解
一、什么是SpringBoot starter机制
SpringBoot中的starter是一种非常重要的机制(自动化配置)，能够抛弃以前繁杂的配置，将其统一集成进starter，
应用者只需要在maven中引入starter依赖，SpringBoot就能自动扫描到要加载的信息并启动相应的默认配置。
starter让我们摆脱了各种依赖库的处理，需要配置各种信息的困扰。SpringBoot会自动通过classpath路径下的类发现需要的Bean，
并注册进IOC容器。SpringBoot提供了针对日常企业应用研发各种场景的spring-boot-starter依赖模块。
所有这些依赖模块都遵循着约定成俗的默认配置，并允许我们调整这些配置，即遵循“约定大于配置”的理念。
二、为什么要自定义starter ？
在我们的日常开发工作中，经常会有一些独立于业务之外的配置模块，我们经常将其放到一个特定的包下，
然后如果另一个工程需要复用这块功能的时候，需要将代码硬拷贝到另一个工程，重新集成一遍，麻烦至极。
如果我们将这些可独立于业务代码之外的功配置模块封装成一个个starter，复用的时候只需要将其在pom中引用依赖即可，
SpringBoot为我们完成自动装配，简直不要太爽
三、什么时候需要创建自定义starter？
在我们的日常开发工作中，可能会需要开发一个通用模块，以供其它工程复用。SpringBoot就为我们提供这样的功能机制，
我们可以把我们的通用模块封装成一个个starter，这样其它工程复用的时候只需要在pom中引用依赖即可，
由SpringBoot为我们完成自动装配。
常见场景：
1.通用模块-短信发送模块
2.基于AOP技术实现日志切面
3.分布式雪花ID，Long-->string，解决精度问题
jackson2/fastjson
4.微服务项目的数据库连接池配置
5.微服务项目的每个模块都要访问redis数据库，每个模块都要配置redisTemplate
也可以通过starter解决
自动加载核心注解说明
四、自定义starter的开发流程（案例：为短信发送功能创建一个starter）
创建Starter项目
starter项目和SpringBoot工程结构没有什么区别
1、细节：命名规范
SpringBoot官方命名方式
格式：spring-boot-starter-{模块名}
举例：spring-boot-starter-web
自定义命名方式
格式：{模块名}-spring-boot-starter
举例：mystarter-spring-boot-starter
由于的这里只做个案例给大家看，就只需要添加这几项就好了....
2.必须引入的依赖
<!--表示两个项目之间依赖不传递；不设置optional或者optional是false，表示传递依赖-->
<!--例如：project1依赖a.jar(optional=true),project2依赖project1,则project2不依赖a.jar-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-configuration-processor</artifactId>
<optional>true</optional>
</dependency>该依赖在上面像我一样选择了的，它会自动生成在pom.xml文件中
3.编写相关属性类(XxxProperties)：例如 SmsProperties.java
代码如下：
package com.zking.smscloudspringbootstarter.sms;
import org.springframework.boot.context.properties.ConfigurationProperties;
@ConfigurationProperties("smscloud.sms")
public class SmsProperties {
private String accessKeyId;//访问ID、即帐号
private String accessKeySecret;//访问凭证，即密码
public SmsProperties() {
}
public String getAccessKeyId() {
return accessKeyId;
}
public void setAccessKeyId(String accessKeyId) {
this.accessKeyId = accessKeyId;
}
public String getAccessKeySecret() {
return accessKeySecret;
}
public void setAccessKeySecret(String accessKeySecret) {
this.accessKeySecret = accessKeySecret;
}
} @ConfigurationProperties注解基本用法，前缀定义了哪些外部属性将绑定到类的字段上
根据 Spring Boot 宽松的绑定规则，类的属性名称必须与外部属性的名称匹配
我们可以简单地用一个值初始化一个字段来定义一个默认值
类本身可以是包私有的
类的字段必须有公共 setter 方法
注意：SmsProperties代码写完后会报如下错误，这是正常的，因为
还有配置类AutoConfig和一个注解@EnableConfigurationProperties没有加
Not registered via @EnableConfigurationProperties or marked as Spring component
4.编写Starter项目的业务功能
ISmsService和SmsServiceImpl
package com.zking.smscloudspringbootstarter.sms;
public interface ISmsService {
/**
* 发送短信
*
* @param phone 要发送的手机号
* @param signName 短信签名-在短信控制台中找
* @param templateCode 短信模板-在短信控制台中找
* @param data 要发送的内容
*/
void send(String phone, String signName, String templateCode, String data);
}
public class SmsServiceImpl implements ISmsService{
private String accessKeyId;//访问ID、即帐号
private String accessKeySecret;//访问凭证，即密码
public SmsServiceImpl(String accessKeyId, String accessKeySecret) {
this.accessKeyId = accessKeyId;
this.accessKeySecret = accessKeySecret;
}
@Override
public void send(String phone, String signName, String templateCode, String data) {
System.out.println("接入短信系统，accessKeyId=" + accessKeyId + ",accessKeySecret=" + accessKeySecret);
System.out.println("短信发送，phone=" + phone + ",signName=" + signName + ",templateCode=" + templateCode + ",data=" + data);
}
}5.编写自动配置类AutoConfig
1. @Configuration： 定义一个配置类
2. @EnableConfigurationProperties：注解的作用是@ConfigurationProperties注解生效。
如果只配置@ConfigurationProperties注解，在IOC容器中是获取不到properties配置文件转化的bean的
代码如下：
package com.zking.smscloudspringbootstarter.config;
import com.zking.smscloudspringbootstarter.sms.SmsProperties;
import com.zking.smscloudspringbootstarter.sms.SmsServiceImpl;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import javax.annotation.Resource;
@Configuration //表示该类为配置类
@EnableConfigurationProperties({SmsProperties.class})
public class SmsAutoConfig {
@Resource
private SmsProperties smsProperties;
@Bean
public SmsServiceImpl smsServiceImpl(){
return new SmsServiceImpl(smsProperties.getAccessKeyId(),smsProperties.getAccessKeySecret());
}
}6.编写spring.factories文件加载自动配置类
1.在resources下新建META-INF文件夹，然后创建spring.factories文件
2.在该文件中加入如下配置，该配置指定上步骤中定义的配置类为自动装配的配置
org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.zking.zzcloudspringbootstarter.config.SmsAutoConfig
注：其中AutoConfig是starter配置文件的类限定名，多个之间逗号分割，还可以\进行转义即相当于去掉后面换行和空格符号
7.打包安装
打包时需要注意一下，SpringBoot项目打包的JAR是可执行JAR，它的类放在BOOT-INF目录下，如果直接作为其他项目的依赖，会找不到类。可以通过修改pom文件来解决，代码如下：
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<classifier>exec</classifier>
</configuration>
</plugin>然后再进行打包
打包成功后就可以再其他项目引用了，我们可以再maven仓库中看到
我们先查看下自己的maven仓库放哪了，然后去找到对应的地方
上面就是打包成功的样子
8.其它项目引用
1.首先在其他项目的pom.xnml中引入依赖
2、在application.yml文件中添加配置
然后我们可以写一个测试类来测试一下
以上就是案例的一个流程，可以看到我们是可以在其他项目中可以看到我们想要是功能的
总结
本文简单介绍了下springboot中starter机制，以及一个案例的编写。如有不足，欢迎补充
敖丙说过：你知道的越多，不知道的越多
到此这篇关于Java SpringBoot自定义starter详解的文章就介绍到这了,更多相关Java SpringBoot自定义starter内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
相关文章
springboot中request和response的加解密实现代码
这篇文章主要介绍了springboot中request和response的加解密实现,在springboot中提供了RequestBodyAdviceAdapter和ResponseBodyAdvice，利用这两个工具可以非常方便的对请求和响应进行预处理，需要的朋友可以参考下2022-06-06
这篇文章主要介绍了使用try-with-resource机制关闭连接的操作，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2021-07-07
这篇文章主要介绍了浅谈一下Java中枚举的用法,枚举是一个被命名的整型常数的集合，用于声明一组带标识符的常数,当一个变量有几种固定可能的取值时，就可以将它定义为枚举类型,需要的朋友可以参考下2023-04-04
springboot web项目中 Set-Cookie 失败原因及解决办法
这篇文章主要介绍了springboot web项目中 Set-Cookie 失败原因及解决办法,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2023-10-10
Spring Boot中使用Swagger3.0.0版本构建RESTful APIs的方法
Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务，这篇文章主要介绍了Spring Boot中使用Swagger3.0.0版本构建RESTful APIs的方法,需要的朋友可以参考下2022-11-11
这篇文章主要介绍了SpringBoot+Mybatis实现登录注册的示例代码，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2021-03-03
这篇文章主要介绍了spring boot教程之建立第一个HelloWorld的相关资料,需要的朋友可以参考下2022-08-08
这篇文章主要介绍了Spring Boot2发布调用REST服务实现方法,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2020-04-04
这篇文章主要介绍了@Valid 无法校验List<E>的问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2021-10-10
这篇文章主要介绍了java网络爬虫连接超时解决的问题，分享了一则使用httpclient解决连接超时的Java爬虫实例代码，小编觉得还是挺不错的，具有一定借鉴价值，需要的朋友可以参考下2018-01-01
最新评论