下面主要介绍,在项目开发中需要集成短信服务,处理相关业务(此处本人使用的是腾讯云短信服务)
腾讯云短信服务步骤
登录腾讯云
- 注册腾讯云
- 个人实名认证
- 进入到控制台, 在云产品中找到短信
默认是没有开通的,阅读服务协议后,点击开始接入
目前来说,只要实名认证过的,直接就可以开通短信服务
这个时候,就可以查看短信控制面板了
测试短信发送
快速开始
现在创建签名申请,网站的话,需要备案比较麻烦,可以用自己的微信去注册一个公众号,我这边目前已经有公众号,所以使用公众号就可以使用短信服务(此处如何注册公众号,可以自行查阅资料)
下图为网图
创建短信模板
此处申请说明,请按实际的目的写,请勿编造(这样通过率高)
接下来耐心等待
初次使用,会有100条免费短信使用,这要比其他云厂商人性化
审核成功后就可以发送了
测试手动发送短信
excel格式为下图所示
点击发送
集成代码进行短信发送
创建秘钥
在pom.xml中引入腾讯云相关依赖
在相关工程下面的pom文件中加入腾讯云短信的依赖(如果不是maven的工程,就需要下载对应的jar包)具体可查看官方文档 腾讯云短信 Java SDK
<dependency>
<groupId>com.tencentcloudapi</groupId>
<artifactId>tencentcloud-sdk-java</artifactId>
<version>3.1.270</version><!-- 注:这里只是示例版本号(可直接使用),可获取并替换为 最新的版本号,注意不要使用4.0.x版本(非最新版本) -->
</dependency>
编写配置文件
注:因为此处整合了redis设置验证码过期时间,所以此处需要添加redis配置
# 服务端口
server.port=8204
# 服务名
spring.application.name=service-msm
#返回json的全局时间格式
spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
spring.jackson.time-zone=GMT+8
#redis配置
spring.redis.host=
spring.redis.port=
spring.redis.database= 1
spring.redis.timeout=1800000
spring.redis.lettuce.pool.max-active=20
spring.redis.lettuce.pool.max-wait=-1
#最大阻塞等待时间(负数表示没限制)
spring.redis.lettuce.pool.max-idle=5
spring.redis.lettuce.pool.min-idle=0
创建controller
@Autowired
private MsmService msmService;
@Autowired
private RedisTemplate<String, String> redisTemplate;
@GetMapping("/send/{phone}")
@ApiOperation(value = "发送手机验证码")
public Result sendCode(@PathVariable String phone) {
//从redis获取验证码,如果获取获取到,返回ok
// key 手机号 value 验证码
String code = redisTemplate.opsForValue().get(phone);
if (!StringUtils.isEmpty(code)) {
return Result.success(code);
}
//如果从redis获取不到
//生成验证码
code = RandomUtils.getSixBitRandom();
//整合腾讯云短信服务进行发送
boolean flag = msmService.send(phone, code);
if (flag) {
//生成验证码放到redis里面,设置有效时间
redisTemplate.opsForValue().set(phone, code, 5, TimeUnit.MINUTES);
return Result.success();
}
return Result.fail().message("发送短信失败");
}
生成验证码的工具类
/**
* 生成验证码的工具类
* <p>
* 创建时间: 2022-03-20 22:21
*
* @author fuxshen
* @version v1.0.0
* @since v1.0.0
*/
public class RandomUtils {
private static final Random random = new Random();
private static final DecimalFormat fourdf = new DecimalFormat("0000");
private static final DecimalFormat sixdf = new DecimalFormat("000000");
/**
* 生成四位验证码
*
* @return java.lang.String
* @Description
* @author fuxshen
* @date 2022-03-20 22:23:22
**/
public static String getFourBitRandom() {
return fourdf.format(random.nextInt(10000));
}
/**
* 生成六位验证码
*
* @return java.lang.String
* @Description
* @author fuxshen
* @date 2022-03-20 22:23:37
**/
public static String getSixBitRandom() {
return sixdf.format(random.nextInt(1000000));
}
/**
* 给定数组,抽取n个数据
*
* @param list
* @param n
* @return
*/
public static ArrayList getRandom(List list, int n) {
Random random = new Random();
HashMap<Object, Object> hashMap = new HashMap<Object, Object>();
// 生成随机数字并存入HashMap
for (int i = 0; i < list.size(); i++) {
int number = random.nextInt(100) + 1;
hashMap.put(number, i);
}
// 从HashMap导入数组
Object[] robjs = hashMap.values().toArray();
ArrayList r = new ArrayList();
// 遍历数组并打印数据
for (int i = 0; i < n; i++) {
r.add(list.get((int) robjs[i]));
System.out.print(list.get((int) robjs[i]) + "\t");
}
System.out.print("\n");
return r;
}
}
创建service
import com.tencentcloudapi.common.Credential;
import com.tencentcloudapi.common.exception.TencentCloudSDKException;
//导入可选配置类
import com.tencentcloudapi.common.profile.ClientProfile;
import com.tencentcloudapi.common.profile.HttpProfile;
// 导入 SMS 模块的 client
import com.tencentcloudapi.sms.v20190711.SmsClient;
// 导入要请求接口对应的 request response 类
import com.tencentcloudapi.sms.v20190711.models.SendSmsRequest;
import com.tencentcloudapi.sms.v20190711.models.SendSmsResponse;
import org.springframework.stereotype.Service;
import org.springframework.util.StringUtils;
/**
* 短信相关接口实现类
* <p>
* 创建时间: 2022-03-20 21:46
*
* @author fuxshen
* @version v1.0.0
* @since v1.0.0
*/
@Service
public class MsmServiceImpl implements MsmService {
@Override
public boolean send(String phone, String code) {
//判断手机是否为null
if (StringUtils.isEmpty(phone)){
return false;
}
try {
/* 必要步骤:
* 实例化一个认证对象,入参需要传入腾讯云账户密钥对 secretId 和 secretKey
* 本示例采用从环境变量读取的方式,需要预先在环境变量中设置这两个值
* 您也可以直接在代码中写入密钥对,但需谨防泄露,不要将代码复制、上传或者分享给他人
* CAM 密钥查询:https://console.cloud.tencent.com/cam/capi
*/
Credential cred = new Credential("secretId", "secretKey");
/* 实例化 SMS 的 client 对象
* 第二个参数是地域信息,可以直接填写字符串 ap-guangzhou,或者引用预设的常量 */
SmsClient client = new SmsClient(cred, "ap-guangzhou");
/* 实例化一个请求对象,根据调用的接口和实际情况,可以进一步设置请求参数
* 您可以直接查询 SDK 源码确定接口有哪些属性可以设置
* 属性可能是基本类型,也可能引用了另一个数据结构
* 推荐使用 IDE 进行开发,可以方便地跳转查阅各个接口和数据结构的文档说明 */
SendSmsRequest req = new SendSmsRequest();
/* 填充请求参数,这里 request 对象的成员变量即对应接口的入参
* 您可以通过官网接口文档或跳转到 request 对象的定义处查看请求参数的定义
* 基本类型的设置:
* 帮助链接:
* 短信控制台:https://console.cloud.tencent.com/smsv2
* sms helper:https://cloud.tencent.com/document/product/382/3773 */
/* 短信应用 ID: 在 [短信控制台] 添加应用后生成的实际 SDKAppID,例如1400006666 */
String appid = "1400006666 ";
req.setSmsSdkAppid(appid);
/* 短信签名内容: 使用 UTF-8 编码,必须填写已审核通过的签名,可登录 [短信控制台] 查看签名信息 */
String sign = "签名内容";
req.setSign(sign);
/* 模板 ID: 必须填写已审核通过的模板 ID,可登录 [短信控制台] 查看模板 ID */
String templateID = "13406824";
req.setTemplateID(templateID);
/* 下发手机号码,采用 e.164 标准,+[国家或地区码][手机号]
* 例如+8613711112222, 其中前面有一个+号 ,86为国家码,13711112222为手机号,最多不要超过200个手机号*/
String[] phoneNumbers = {
"+86"+phone};
req.setPhoneNumberSet(phoneNumbers);
/* 模板参数: 若无模板参数,则设置为空
模版参数,从前往后对应的是模版的{1}、{2},可以传多个用逗号隔开*/
String[] templateParams = {
code};
req.setTemplateParamSet(templateParams);
/* 通过 client 对象调用 SendSms 方法发起请求。注意请求方法名与请求对象是对应的
* 返回的 res 是一个 SendSmsResponse 类的实例,与请求对象对应 */
SendSmsResponse res = client.SendSms(req);
// 输出 JSON 格式的字符串回包
System.out.println(SendSmsResponse.toJsonString(res));
// 可以取出单个值,您可以通过官网接口文档或跳转到 response 对象的定义处查看返回字段的定义
System.out.println(res.getRequestId());
return true;
} catch (TencentCloudSDKException e) {
e.printStackTrace();
}
return false;
}
}