7 分钟实现 Java 发送短信功能!
阅读文本大概需要 7 分钟。
前言
前几日,有粉丝后台私信我如何实现发送短信的功能,刚好久一刚刚用到了这个功能,就把具体的实现过程记录下来,分享给大家。
我们日常使用的软件或者网站,大部分都在使用短信业务,比如注册、验证码功能。还有一些特定的业务需要发送短信通知用户等。有了需求就会有平台提供服务,国内有很多互联网公司都提供短信业务,比如阿里、腾讯、七牛。国外有 Twillo 公司同样可以提供服务,也有相应的额度。本篇文章提及的是腾讯提供的短信服务。
其实实现发送短信功能非常简单,只需要在服务提供平台进行注册以及简单的配置。创建签名和模板,采用官方提供的SDK,调用接口即可。
我使用的是腾讯提供的短信业务,腾讯提供每个月100 的免费额度,用来测试足够了。
1、腾讯短信服务
复制下方的链接到浏览器打开,就可以访问腾讯短信服务的页面。进行简单的注册,下一步开始正题。
https://console.cloud.tencent.com/sms/smslist
2、创建应用
首先第一步要添加一个应用,这个应用你可以理解为一种方便管理自己的短信配置的模块,通过应用的名字就可以得知:这个应用对应的是自己的哪个项目,至于起什么名字并无大碍。比如我命名为:在线打印。
3、点击刚刚创建的应用名称,进入应用配置。在这个页面,你需要注意下方图片圈出来的两个参数,分别是:SDK AppID、App Key。后面代码的参数会用到这两个参数。
4、点击「国内短信」,在这里可以看到自己发送短信的情况。包括发送成功的次数、失败的次数等等。当然现在的任务是进行配置模板。
5、点击「短信内容配置」,在这里我们需要配置短信签名和短信正文。什么是短信签名呢,拿我们收到过的短信来说:“【阿里巴巴】您的验证码为:56659,请妥善保管好,切勿告知他人 ”。这条短息中 阿里巴巴 就是短信签名。
6、点击创建短信签名,这里可以选择签名的类型。是用于公司还是APP、网站。根据自己的情况来就可以,但是如果选择「网站」签名类型的话,需要提供备案的截屏,如果没备案的可以去操作一下。如果选择「公司」需要提供营业执照截屏。
对于没有备案的网站和营业执照的朋友,久一也帮你探索好了别的道路,可以使用 阿里云 的短信服务,不过对于没有营业执照的情况,阿里提供的短信服务只能申请验证码的功能,想一些通知用户取货、通知取货码等等通用功能是没办法申请的。
阿里短信服务网址:
account.aliyun.com/login/login.html
下面链接是阿里云短信服务的博文,流程差不多:
blog.csdn.net/qq_38225558/article/details/84954935。
点击「确认」后,只需要等待官方任务对域名进行审核。
7、创建「短信正文」,短信正文就是短信签名后面具体的短信内容了,比如:”您的文件打印完毕,请在在{1}前凭取件码{2},至{3}取件,若有问题请联系店主{4}。“其中用括号括起来的数字是一个变量,这个需要根据我们具体的业务逻辑来动态填充。后面代码就会明白!比如下面是我创建的两个短信正文。
8、等待审核通过,刚刚创建短信签名和短信正文成功,状态会是:审核中,如果不是 违法或者格式不正确,一般半小时就能审核成功,如果审核通过,可以记录下短信签名的名称以及短信正文的ID。
9、完事具备、只欠东风。点开「快速入门」,阅读短信业务的API 文档,如果不想度可以直接看我下面的代码。
10、我们选择Java SDK文档进行查阅。
11、编写代码
引入依赖,我使用的Maven搭建项目,管理Jar包。如果不了解Maven工具,可以查看本订阅号历史文章学习:Maven学习笔记 需要在 pom.xml 中添加如下依赖:
<dependency>
<groupId>com.github.qcloudsms</groupId>
<artifactId>qcloudsms</artifactId>
<version>1.0.6</version>
</dependency
准备必要参数,这些参数都是上方我们提到的,根据自己的情况进行填写即可。
// 短信应用 SDK AppID
int appid = 1400009099; // 1400开头
// 短信应用SDK AppKey
String appkey = "9ff91d87c2cd7cd0ea762f141975d1df37481d48700d70ac37470aefc60f9bad";
// 需要发送短信的手机号码
String[] phoneNumbers = {"21212313123", "12345678902", "12345678903"};
// 短信模板ID,需要在短信应用中申请
int templateId = 7839; // NOTE: 这里的模板ID`7839`只是一个示例,真实的模板ID需要在短信控制台中申请
//templateId7839对应的内容是"您的验证码是: {1}"
// 签名
String smsSign = "腾讯云"; // NOTE: 签名参数使用的是`签名内容`,而不是`签名ID`。这里的签名"腾讯云"只是一个示例,真实的签名需要在短信控制台申请
指定模板 ID 单发短信, 比如我们置顶的短信模板为:您的文件打印完毕,请在在{1}前凭取件码{2},至{3}取件,若有问题请联系店主{4}。注意下方的 params。
public static void sendSms(){
try {
String[] params = {"20:10","521-521","南苑店面,南苑住宿区","1785417xxxx"};//数组具体的元素个数和模板中变量个数必须一致,例如示例中templateId:5678对应一个变量,参数数组中元素个数也必须是一个
SmsSingleSender ssender = new SmsSingleSender(appid, appkey);
SmsSingleSenderResult result = ssender.sendWithParam("86", phoneNumbers[0],
templateId, params, smsSign, "", ""); // 签名参数未提供或者为空时,会使用默认签名发送短信
System.out.println(result);
} catch (HTTPException e) {
// HTTP响应码错误
e.printStackTrace();
} catch (JSONException e) {
// json解析错误
e.printStackTrace();
} catch (IOException e) {
// 网络IO错误
e.printStackTrace();
}
}
12、测试运行 sendSms 函数:
总结:
上面就是比较实用的短信发送实战,如果发送失败,可以根据接口调用返回的result的错误代码查阅官方文档,如果按照我的步骤一步一步来应该不会出错。
至此,我们揭开了发送短信业务的什么面纱。如果你阅读完本文有所收获,还请多多转发、点赞支持。你的转发是最大的赞赏,宝贝儿!
关注订阅号「Web项目聚集地」回复:「技术文章」,即可获取更改实战教程、实用教程,我们明天见!
推荐阅读
4. 什么是消息队列?