SpringBoot3集成SMS4J实现短信+OA双渠道消息发送
做后端业务开发,短信发送是绕不开的基础功能,但直接对接各家云厂商短信SDK,不仅配置繁琐、业务耦合度高,换个服务商就要重构大半代码,纯纯费力不讨好。而且日常项目里,除了短信验证码,OA系统消息通知也是高频需求,单独对接OA接口又要额外写一套逻辑。最近用SpringBoot3做项目,直接上手了SMS4J这个开源工具,不仅适配SpringBoot3.x、一键切换多厂商短信,还能同步集成OA消息通知,一套工具搞定双渠道发送。
一、项目环境与核心依赖
先确认基础环境,我这边用的是SpringBoot 3.2.5、JDK17。
第一步先引入Maven核心依赖,直接在pom.xml中添加官方starter。
<!-- SMS4J SpringBoot3启动器 官方最新稳定版3.3.5 -->
<dependency>
<groupId>org.dromara.sms4j</groupId>
<artifactId>sms4j-spring-boot-starter</artifactId>
<version>3.3.5</version>
</dependency>
<!-- SMS4J OA消息通知 -->
<dependency>
<groupId>org.dromara.sms4j</groupId>
<artifactId>sms4j-oa-core</artifactId>
<version>3.3.5</version>
</dependency>依赖引入后刷新Maven,等待下载完成即可,不用额外做依赖排除。
二、核心配置:短信+OA一体化配置
接下来是核心配置环节,不用写自定义配置类,直接在application.yml中同时配置短信和OA消息,一份配置文件管理双渠道,切换厂商和OA地址只改配置,业务代码零改动。我以阿里云短信+通用OA通知为例,配置逻辑清晰易懂。
提前准备好阿里云短信参数:AccessKey、Secret、短信签名、模板ID;OA相关参数:OA接口地址、应用密钥、审批人/接收人标识,都是后台可直接获取的基础参数。
spring:
application:
name: sms4j-demo
# SMS4J核心配置,3.3.5版本支持短信+OA双配置
sms:
config-type: yaml
blends:
# 阿里云短信配置
aliyun:
supplier: alibaba
accessKeyId: 您的阿里云AccessKey
accessKeySecret: 您的阿里云Secret
signature: 短信签名
templateId: SMS_215125134
templateName: code
requestUrl: dysmsapi.aliyuncs.com
oas:
oaDingTalkByYaml: # configId
isEnable: true # 表示该配置是否生效(默认生效,false表示不生效)
supplier: ding_ding # 厂商标识
tokenId: 您的accessKey # webhook 中的 access_token
sign: 您的sign # 安全设置在验签模式下才的秘钥,非验签模式没有此值不管是新增腾讯云、华为云短信,还是调整OA对接参数,都只需要在blends下新增或修改配置块,业务逻辑完全不用动,多渠道切换和扩展极其灵活,这也是SMS4J的核心优势。
三、代码实现:短信+OA双发送接口
配置完成后直接写业务代码,SMS4J通过工厂类统一管理渠道实例,短信和OA发送调用逻辑高度一致,代码极度简洁,适配登录验证码、业务审批通知等场景。
import cn.hutool.core.util.RandomUtil;
import org.dromara.oa.api.OaSender;
import org.dromara.oa.comm.entity.Request;
import org.dromara.oa.comm.entity.Response;
import org.dromara.oa.comm.enums.MessageType;
import org.dromara.oa.core.provider.factory.OaFactory;
import org.dromara.sms4j.api.SmsBlend;
import org.dromara.sms4j.api.entity.SmsResponse;
import org.dromara.sms4j.core.factory.SmsFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.ArrayList;
@RestController
@RequestMapping("/sms")
public class SmsController {
/**
* 通用短信验证码发送接口
* @param phone 接收短信的手机号
* @return 发送结果反馈
*/
@GetMapping("/send/{phone}")
public String sendSmsCode(@PathVariable String phone) {
// 获取对应厂商标识的短信实例,和yml配置一一对应
SmsBlend smsBlend = SmsFactory.getSmsBlend("aliyun");
// 生成6位纯数字验证码,适配绝大多数验证码场景
String code = RandomUtil.randomNumbers(6);
// 执行短信发送,参数顺序严格匹配短信模板变量顺序
SmsResponse response = smsBlend.sendMessage(phone, code);
// 结果返回,开发阶段可直接返回验证码调试,生产环境建议隐藏
if (response.isSuccess()) {
return "短信发送成功,验证码:" + code;
}
return "短信发送失败,失败原因:" + response.getData().toString();
}
/**
* 通用OA通知发送接口
* @param phone 接收通知的手机号
* @return 发送结果反馈
*/
@GetMapping("/send/oa/notice/{phone}")
public String sendOANotice(@PathVariable String phone) {
String configId = "oaDingTalkByYaml";
OaSender alarm = OaFactory.getSmsOaBlend(configId);
Request request = new Request();
ArrayList<String> phones = new ArrayList<>();
phones.add(phone);
// 支持通过手机号@
request.setPhoneList(phones);
// 支持@all
// request.setIsNoticeAll(true);
request.setContent("测试消息");
Response response = alarm.sender(request, MessageType.DING_TALK_TEXT);
// 结果返回
if (response.isSuccess()) {
return "OA通知消息发送成功";
}
return "OA通知消息发送失败,失败原因:" + response.getData().toString();
}
}注意:模板变量顺序要和配置、后台模板完全匹配,OA消息可根据内部需求调整模板内容,支持文本、审批提醒等多种格式,调用方式和短信完全一致,学习成本极低。
四、核心避坑提示
- 参数一致性:短信和OA的密钥、地址、模板ID必须和后台完全一致,空格、字符错误会直接导致发送失败;
- 渠道标识对应:SmsFactory获取实例的标识,必须和yml中blends下的配置名一一对应,不可写错;
- 生产环境规范:敏感密钥切勿硬编码,建议放到Nacos、Apollo配置中心,OA内网地址做好权限管控;
- 单渠道 fallback:可加判断逻辑,某一渠道失败时,另一渠道兜底,提升消息送达率。
五、总结
整体集成全程不到10分钟,依托SMS4J 3.3.5最新版本,SpringBoot3集成零兼容问题,不仅搞定了多厂商短信的解耦对接,还顺带实现了OA消息通知,一套框架管理双渠道消息,代码简洁、扩展灵活。不管是中小型项目的基础消息功能,还是需要多渠道灾备的业务场景,都能快速落地。
到此这篇关于SpringBoot3集成SMS4J实现短信+OA双渠道消息发送的文章就介绍到这了,更多相关SpringBoot3集成SMS4J双渠道消息发送内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!
相关文章
Java 通过手写分布式雪花SnowFlake生成ID方法详解
SnowFlake是twitter公司内部分布式项目采用的ID生成算法,开源后广受国内大厂的好评。由这种算法生成的ID,我们就叫做SnowFlakeID,下面我们来详细看看2022-04-04


最新评论