最近在给我的AI工具（
https://ai.quanyouhulian.com/）新增个**短信及邮箱登录功能，按传统方式，一般是在后端引入各短信服务商SDK-jar包，以及短信邮件的maven包（javax.mail**）
该方式不仅需要耗费大量时间去开发对接，而且写出来的代码也不优雅，今天要和大家分享一款jar包，聚合了当前主流短信服务厂商，以及邮件发送功能，只需不到10分钟，便可快速完成短信及邮件发送功能，写出的代码也优雅高端！
快速对接短信及邮件详细步骤
短信接入
1、引入jar包依赖
pom.xml加入以下依赖，这里我们使用最新版本3.3.3，该版本支持邮件发送！
org.dromara.sms4j
sms4j-spring-boot-starter
3.3.3
**该包已经被收纳进阿里云公共仓库**了，只要你maven的setting.xml镜像配置了阿里云的公共仓库：
http://maven.aliyun.com/nexus/content/groups/public/，便能自动获取到该类
2、获取阿里云AccessKey
进入阿里云：
https://ecs.console.aliyun.com/，登录主账号点击右上角进入AccessKey界面
创建Accesskey，把这一串Accesskey ID和Accesskey Secret保存好，配置会用到
添加短信签名，该签名就是国内短信开头【】那一部分，下面配置会用到
3、配置阿里云密钥
这里有两种方式，一种是用yml文件配置，一种直接写在初始化bean内，sms4j3.0之后版本推荐使用bean配置！
新增2个类，AliReadConfig和Demo
import java.util.List;
import org.dromara.sms4j.aliyun.config.AlibabaConfig;
import org.dromara.sms4j.core.datainterface.SmsReadConfig;
import org.dromara.sms4j.provider.config.BaseConfig;
import org.springframework.stereotype.Component;
import lombok.extern.slf4j.Slf4j;
@Slf4j
@Component
public class AliReadConfig implements SmsReadConfig {
@Override
public BaseConfig getSupplierConfig(String configId) {
// 这里需要注意，UniConfig只是代表合一短信的配置类，仅做示例使用，根据不同厂商选择实例化不同的配置类
AlibabaConfig alibabaConfig = new AlibabaConfig();
// 此处仅为示例，实际环境中，数据可以来自任意位置，
log.info("开始配置阿里云短信");
alibabaConfig.setAccessKeyId("LTAIxxxxxxxxxxx");
alibabaConfig.setAccessKeySecret("1Nyxxxxxxxxxxxxxxxxxxxxxx");
alibabaConfig.setSignature("圈友互联");
return alibabaConfig;
}
@Override
public List getSupplierConfigList() {
// 初始化一个配置列表
// 返回配置列表
return null;
}
}
这里初始化只需要加3个参数：AccessKeyId、AccessKeySecret、Signature
另外新增个Demo类，主要作用加载AliReadConfig配置
import org.dromara.sms4j.comm.constant.SupplierConstant;
import org.dromara.sms4j.core.factory.SmsFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.event.ContextRefreshedEvent;
import org.springframework.context.event.EventListener;
import org.springframework.stereotype.Component;
import lombok.extern.slf4j.Slf4j;
@Slf4j
@Component
public class Demo {
@Autowired
AliReadConfig aliReadConfig;
@EventListener
public void init(ContextRefreshedEvent event) {
log.info("开始创建SmsBlend 短信实例");
// 创建SmsBlend 短信实例
SmsFactory.createSmsBlend(aliReadConfig, SupplierConstant.ALIBABA);
}
}
4、发送短信测试
import java.util.LinkedHashMap;
import org.dromara.sms4j.api.SmsBlend;
import org.dromara.sms4j.api.entity.SmsResponse;
import org.dromara.sms4j.comm.constant.SupplierConstant;
import org.dromara.sms4j.core.factory.SmsFactory;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import com.baomidou.mybatisplus.extension.api.R;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
@Slf4j
@Validated
@RequiredArgsConstructor
@RestController
@RequestMapping("/demo/sms")
public class SMSController {
/**
* 发送短信Aliyun
*
* @param phones 电话号
* @param templateId 模板ID
*/
@GetMapping("/sendAliyun")
public R<Object> sendAliyun(String phones, String templateId) {
SmsBlend smsBlend = SmsFactory.getSmsBlend(SupplierConstant.ALIBABA);
log.info("开始发送短信");
LinkedHashMap messages = new LinkedHashMap<>();
messages.put("code", "123321");
SmsResponse smsResponse = smsBlend.sendMessage("18588443913", "SMS_280655083", messages);
return R.ok(smsResponse);
}
}
这里SmsFactory.getSmsBlend(SupplierConstant.ALIBABA);获取的configId便是前面Demo配置的那个id
这里模板id对应的是云厂商的模版CODE，以阿里云（
https://dysms.console.aliyun.com/domestic/text/template）为例：
使用postman调用本地controller方法
查看短信接收情况，成功！
5、其他类型短信场景发送
SmsBlend还支持异步，延时短信发送，直接调用即可，框架已经封装了实现逻辑！
邮件接入
1、引入jar包依赖
pom.xml新增以下jar包依赖
org.dromara.sms4j
sms4j-Email-core
3.3.3
2、获取邮件授权码
进到163邮箱，点击设置，开启IMAP、POP3服务
把这一串授权码拷贝下来，代码MailSmtpConfig设置时候会用到
3、代码配置MailSmtpConfig参数
继续在之前的短信初始配置里加上邮件SMTP配置，这里把Demo名字改成SmsConfig，该描述准确些
具体实现代码如下，这里端口使用465端口，默认用ssl协议会使用465端口，代码里授权码直接改成自己的即可直接使用
import org.dromara.email.comm.config.MailSmtpConfig;
import org.dromara.email.core.factory.MailFactory;
import org.dromara.sms4j.comm.constant.SupplierConstant;
import org.dromara.sms4j.core.factory.SmsFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.event.ContextRefreshedEvent;
import org.springframework.context.event.EventListener;
import org.springframework.stereotype.Component;
import lombok.extern.slf4j.Slf4j;
@Slf4j
@Component
public class SmsConfig {
@Autowired
AliReadConfig aliReadConfig;
@EventListener
public void init(ContextRefreshedEvent event) {
log.info("开始创建SmsBlend 短信实例");
// 创建SmsBlend 短信实例
SmsFactory.createSmsBlend(aliReadConfig, SupplierConstant.ALIBABA);
// 以下仅做演示，实际使用需要填入数据
MailSmtpConfig mailconfig = MailSmtpConfig.builder().port("465").fromAddress("f1732459@163.com")
.smtpServer("smtp.163.com").username("f1732459@163.com").nickName("圈友互联AI")
.password("你自己邮箱授权码").build();
MailFactory.put("163mail", mailconfig);
}
}
4、编写邮件发送类
这里填写MailMessage相关参数，使用mailBlend进行邮件发送！
@GetMapping("/sendMail")
public R<Object> sendMail(String receiver) {
MailClient mailBlend = MailFactory.createMailClient("163mail");
String code = SmsUtils.getRandomInt(6);
MailMessage message = MailMessage.Builder()
// 收件人地址，此处可以为字符串的单个地址也可以为一个List的群发地址
// 例如 .mailAddress (new ArrayList().add("XXXXXXXXX@qq.com"))
.mailAddress("a173959@gmail.com")
// 邮件的标题
.title("测试标题")
// 邮件的文字正文，但是如果发送html邮件时候，大多数的邮件服务商会隐藏掉body的信息
.body("测试邮件发送")
// html模板来源，此处与mailAddress相似可以为一个字符串形式的html文件名，此时默认读取resources/template目录下的文件
// 也可以为一个 InputStream 输入流
// 例如 .html(Files.newInputStream(new File("D:\\index.html").toPath()))
.htmlContent("你的最新验证码是: " + code)
/*
* html模板变量，如果你的html不需要变量，则可以为空，这里有多种的用法
* Map map的key为变量名称，map的value为变量的值
* 例如 Map map = new HashMap().put("变量名称","变量值");
* .htmlValues(map)
* 还可以直接写入变量名称和变量值 如.htmlValues("变量名称",“变量值”)
* 此处也可以使用接口进行，接口形式在下方详细介绍
*/
// .htmlValues(variables)
// 抄送人，可以添加一个或多个，使用方式与.mailAddress一致
.cc("173959@163.com")
// 密送人，可以添加一个或多个，使用方式与.mailAddress一致
.bcc("a173959@163.com")
// 附件，此处与.htmlValues使用方法相似，如果你只有一个附件，可以直接填写key value 如果你有多个附件，这里可以接受一个map
// .files(“文件名”,"文件路径")
// //3.0版本支持发送文件自动压缩，你可以选择指定这里的压缩文件名称，框架将会自动将 .files中的所有文件打为一个压缩包并发送
// .zipName("压缩文件名称")
.build();
log.info("开始发送邮件");
mailBlend.send(message);
return R.ok("发送成功");
}
验证码可以使用SmsUtils实现，该工具类提供了一些常用方法
5、测试邮件发送
使用postman调用本地接口
查看邮件接收情况
sms4j使用官方文档
官方文档也有部分参数解释，可以参考：https://sms4j.com/doc3/