自定义starter

目录

一、简介

1、启动器starter命名

2、什么是SpringBoot starter机制

3、为什么要自定义starter

4、什么时候需要创建自定义starter

5、自动加载核心注解说明 

二、自定义starter短信模块

自定义starter的开发流程

1、创建Starter项目

2、编写相关属性类：SmsProperties

3、编写Starter项目的业务功能

4、编写自动配置类SmsAutoConfig.java

5、编写spring.factories文件加载自动配置类

6、打包安装

7、其它项目引用 

三、自定义starterAOP日志模块

自定义starter的开发流程

1、创建Starter项目

2、编写相关属性类：MyLogProperties.java

3、编写Starter项目的业务功能

4、编写自动配置类

5、编写spring.factories文件加载自动配置类

6、打包安装

7、其它项目引用

8、测试

---

一、简介

1、启动器starter命名

#官方
spring-boot-starter-jdbc
spring-boot-starter-web
spring-boot-starter-freemarker
#第三方
sms-spring-boot-starter
myLog-spring-boot-starter

2、什么是SpringBoot starter机制

SpringBoot中的starter是一种非常重要的机制(自动化配置)，能够抛弃以前繁杂的配置，将其统一集成进starter，
应用者只需要在maven中引入starter依赖，SpringBoot就能自动扫描到要加载的信息并启动相应的默认配置。
starter让我们摆脱了各种依赖库的处理，需要配置各种信息的困扰。SpringBoot会自动通过classpath路径下的类发现需要的Bean，
并注册进IOC容器。SpringBoot提供了针对日常企业应用研发各种场景的spring-boot-starter依赖模块。
所有这些依赖模块都遵循着约定成俗的默认配置，并允许我们调整这些配置，即遵循“约定大于配置”的理念。

3、为什么要自定义starter

在我们的日常开发工作中，经常会有一些独立于业务之外的配置模块，我们经常将其放到一个特定的包下，
然后如果另一个工程需要复用这块功能的时候，需要将代码硬拷贝到另一个工程，重新集成一遍，麻烦至极。
如果我们将这些可独立于业务代码之外的功能配置模块封装成一个个starter，复用的时候只需要将其在pom中引用依赖即可，
SpringBoot为我们完成自动装配，简直不要太爽

4、什么时候需要创建自定义starter

在我们的日常开发工作中，可能会需要开发一个通用模块，以供其它工程复用。SpringBoot就为我们提供这样的功能机制，
我们可以把我们的通用模块封装成一个个starter，这样其它工程复用的时候只需要在pom中引用依赖即可，
由SpringBoot为我们完成自动装配。

常见场景：
1.通用模块-短信发送模块
2.基于AOP技术实现日志切面
3.分布式雪花ID，Long–>string，解决精度问题
jackson2/fastjson
4.微服务项目的数据库连接池配置
5.微服务项目的每个模块都要访问redis数据库，每个模块都要配置redisTemplate
也可以通过starter解决

5、自动加载核心注解说明 

二、自定义starter短信模块

自定义starter的开发流程

1.创建Starter项目(spring-initl 2.1.14)
2.定义Starter需要的配置类(Properties)
3.编写Starter项目的业务功能
4.编写自动配置类
5.编写spring.factories文件加载自动配置类
6.打包安装
7.其它项目引用

1、创建Starter项目

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>

2、编写相关属性类：SmsProperties

package com.liaoxin.smsspringbootstart.properties;

import org.springframework.boot.context.properties.ConfigurationProperties;

/**
 * @author liaoxin
 * @create 2022-11-03 19:38
 *
 * 短信发送时一般要提供短信账户凭证
 * spring:
 *     application:
 *         name: sms-spring-boot-start
 * 当需要使用自定义sms模块时，在yml文件中进行配置
 * spboot:
 *     sms:
 *         xxx: sms-spring-boot-start
 *
 *  ConfigurationProperties默认是会报错的，然后需要在strter项目配置类中解决
 */
@ConfigurationProperties(prefix = "spboot.sms")
public class SmsProperties {
    private String accessKeyId;//短信发送接口的账户

    private String accesskeySecret;//短信发送接口的凭证

    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;
    }



}