坚持学习第六天:SpringBoot 2.x 编写自己的Springboot starter

  • 认真是一种态度,坚持是一种品格,优秀是一种习惯!
      最近被因为一场疫情,被关家了。2020愿一切早点好起来。
      在SpringBoot的使用过程中,我们深刻体会到了Springboot starter带来的方便快捷,通过maven构建的项目,只需要在pom.xml中引入某个starter,我们不用写一行代码,只需简单的加些配置,一个基础项目就有了。那我们是否也可以自己搞个自己的SDK,当然可以。
      尝试自己写个简单的DEMO:

基本步骤:

  • 创建SpringBoot项目,引入自动配置依赖:
  • 添加配置文件类(xxxProperties)和自动配置类
  • 封装SDK业务实现
  • 在resources目录下增加META-INF/spring.factpries配置自动配置类
  • 构建SDK包,maven-install发布到本地仓库测试
  • 若有条件发布到自有私库提供给其他项目使用
1.首先创建自己的SpringBoot Starter项目:直接创建一个Maven项目(注意项目名称:自定义名称-spring-boot-starter):如下图
image.png
2.引入自动配置相关依赖
<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.acm</groupId>
    <artifactId>acm-sdk-spring-boot-starter</artifactId>
    <version>1.0-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.6.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <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</artifactId>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.10</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>


</project>
3.创建配置属性类和自动装配Configuration

项目基本结构:


项目基本结构
4.编写对应的实现代码
  • 属性文件,假设我准备支持阿里云和sendCloud的短信API发送
package com.acm.sdk.properties;

import com.acm.sdk.constant.SmsTypes;
import com.acm.sdk.properties.type.AliYun;
import com.acm.sdk.properties.type.SendCloud;
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;

import java.io.Serializable;

/**
 * <p>
 * SmsProperties
 * </p>
 *
 * @author jackcooperz
 * @date 2020/3/11 9:02
 */
@Data
@ConfigurationProperties(prefix = SmsProperties.SMS_NAME_PREFIX)
public class SmsProperties implements Serializable {

    /**
     * 短信配置前缀
     */
    public static final String SMS_NAME_PREFIX = "sms";

    /**
     * 短信API类型 默认短信API类型 默认SendCloud
     */
    private String defaultSmsType = SmsTypes.SEND_CLOUD.getSmsType();

    /**
     * SendCloud 短信API
     */
    private SendCloud sendCloud;

    /**
     * 阿里云 短信API
     */
    private AliYun aliyun;
}
  • 业务实现Service(仅做demo)
package com.acm.sdk.service;

import com.acm.sdk.constant.SmsTypes;
import com.acm.sdk.properties.SmsProperties;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

/**
 * <p>
 * SmsService
 * </p>
 *
 * @author jackcooperz
 * @date 2020/3/11 9:08
 */
@Service
public class SmsService {

    @Autowired
    private SmsProperties smsProperties;

    /**
     * 读取配置文件显示返回测试
     *
     * @return SmsProperties
     */
    public SmsProperties readSmsProperties() {
        return smsProperties;
    }

    /**
     * 发送短信
     *
     * @return String
     */
    public String sendSms() {
        if (SmsTypes.ALI_YUN.getSmsType().equals(smsProperties.getDefaultSmsType())) {
            return "阿里云短信发送成功";
        } else if (SmsTypes.SEND_CLOUD.getSmsType().equals(smsProperties.getDefaultSmsType())) {
            return "sendCloud短信发送成功";
        }
        return "未知的短信API类型,暂不支持";
    }
}
  • 编写自动装配类
package com.acm.sdk.configuration;

import com.acm.sdk.properties.SmsProperties;
import com.acm.sdk.service.SmsService;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

/**
 * <p>
 * SmsAutoConfiguration
 * </p>
 *
 * @author jackcooperz
 * @date 2020/3/11 9:05
 */
@Configuration
@ComponentScan("com.acm.sdk")
@EnableConfigurationProperties(value = {SmsProperties.class})
@ConditionalOnClass(SmsService.class)
public class SmsAutoConfiguration {
}
  • 添加Spring.factories
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
  com.acm.sdk.configuration.SmsAutoConfiguration
  • maven-install构建SDK,
    构建SDK
    构建SDK
编写DEMO测试看看

引入SDK

 <dependency>
            <groupId>com.acm</groupId>
            <artifactId>acm-sdk-spring-boot-starter</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>

配置属性

sms:
  default-sms-type: aliyun
  aliyun:
   signName: test
   accessKeyId: test
   accessKeySecret: test

编写接口测试看看

   @Autowired
    private SmsService smsService;

    @ResponseBody
    @RequestMapping(value = "/readSms")
    public SmsProperties readSms() {
        return smsService.readSmsProperties();
    }
 
    @ResponseBody
    @RequestMapping(value = "/send")
    public String sendSms() {
        return smsService.sendSms();
    }

配置属性读取

发送业务调用

至此一个自己的spring-boot-starter就基本完成了,剩下的就是根据自己的业务封装SDK。
附上项目DEMO地址:https://gitee.com/jingchu/acm-sdk-spring-boot-starter.git

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,636评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,890评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,680评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,766评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,665评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,045评论 1 276
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,515评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,182评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,334评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,274评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,319评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,002评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,599评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,675评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,917评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,309评论 2 345
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,885评论 2 341

推荐阅读更多精彩内容