在日常的开发过程中,短信的发送经常使用(尤其是中小型的外包公司),毕竟不是每个公司都有阿里腾讯一样的实力,
也不是每个都像银行联通等公司一样有内部的短信规程。第三方的短信往往是最常见的解决方案,但是市面上第三方短信服务商众多,
各家都有不同的方式和标准,每次需要使用时候,都需要花费时间去阅读文档和编写相应的工具,为一个短信浪费了太多的精力和时间。
这个工具的目的就是为了统一下各个厂商的短信发送工具的标准,甚至于更换短信厂商只需要更改yml配置文件即可。
新人上路,还望各位大佬多多支持,如果你觉得还算值得鼓励,请用你发财的小手帮助点上一个start
gitee
github
目前刚刚发布第一版本,支持尚少,后续会集成更多的厂商
- 阿里云国内短信
- 腾讯云国内短信
- 华为云国内短信
- 合一短信
- 云片短信
-
maven引入
<dependency> <groupId>kim.wind</groupId> <artifactId>sms-aggregation-spring-boot-starter</artifactId> <version> version </version> </dependency>
-
设置配置文件
sms: # 短信服务商 supplier: alibaba # 是否开启短信发送限制 默认false restricted: true # 以下设置仅在开启短信发送限制后生效 # 是否使用redis进行缓存 默认false redisCache: true # 单账号每日最大发送量 accountMax: 20 # 单账号每分钟最大发送 minuteMax: 2
阿里云配置示意
sms:
# 短信服务商
supplier: alibaba
alibaba:
#阿里云的accessKey
accessKeyId: 您的accessKey
#阿里云的accessKeySecret
accessKeySecret: 您的accessKeySecret
#短信签名
signature: 测试签名
#模板ID 用于发送固定模板短信使用
templateId: SMS_215125134
#模板变量 上述模板的变量
templateName: code
#请求地址 默认为dysmsapi.aliyuncs.com 如无特殊改变可以不用设置
requestUrl: dysmsapi.aliyuncs.com
-
方法使用
public class Demo{ //此处作为演示使用,推荐使用构造注入或set注入 @Autowired private final SmsBlend sms; public void test() { //发送固定模板短信 SmsResponse smsResponse = sms.sendMessage("18888888888","测试固定模板短信"); System.out.println(smsResponse); } }
每一家厂商都对于异步短信有不同的支持,有些甚至没有,为了统一存在一个异步短信,我们配置了一个线程池用于执行异步短信任务,线程池默认配置如下:
sms:
#核心线程池大小
corePoolSize: 10
#最大线程数
maxPoolSize: 30
#队列容量
queueCapacity: 50
#活跃时间
keepAliveSeconds: 60
# 线程名字前缀
threadNamePrefix: sms-executor-
#设置线程池关闭的时候等待所有任务都完成再继续销毁其他的Bean
shutdownStrategy: true
以上线程池为默认的配置,如果有需要可以跟随自己的需求在yml文件进行配置
## 参与贡献
1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request 到 dev分支
- master 正式版分支,最终发布到maven**仓库的版本
- dev 开发分支,贡献的代码将合并到这里,无误后合并至preview
- preview 预览版分支,新的版本和测试性功能将在这里发布