7 分钟实现 Java 发送短信功能

10月13日 收藏 0 评论 3 java开发

7 分钟实现 Java 发送短信功能

转载声明:文章来源https://zhuanlan.zhihu.com/p/66307658

前言

前几日,有粉丝后台私信我如何实现发送短信的功能,刚好久一刚刚用到了这个功能,就把具体的实现过程记录下来,分享给大家。

我们日常使用的软件或者网站,大部分都在使用短信业务,比如注册、验证码功能。还有一些特定的业务需要发送短信通知用户等。有了需求就会有平台提供服务,国内有很多互联网公司都提供短信业务,比如阿里、腾讯、七牛。国外有 Twillo 公司同样可以提供服务,也有相应的额度。本篇文章提及的是腾讯提供的短信服务。

其实实现发送短信功能非常简单,只需要在服务提供平台进行注册以及简单的配置。创建签名和模板,采用官方提供的SDK,调用接口即可。

我使用的是腾讯提供的短信业务,腾讯提供每个月100 的免费额度,用来测试足够了。

1、腾讯短信服务
复制下方的链接到浏览器打开,就可以访问腾讯短信服务的页面。进行简单的注册,下一步开始正题。
https://console.cloud.tencent.com/sms/smslist

2、创建应用
首先第一步要添加一个应用,这个应用你可以理解为一种方便管理自己的短信配置的模块,通过应用的名字就可以得知:这个应用对应的是自己的哪个项目,至于起什么名字并无大碍。比如我命名为:在线打印。

3、点击刚刚创建的应用名称,进入应用配置。
在这个页面,你需要注意下方图片圈出来的两个参数,分别是:SDK AppID、App Key。后面代码的参数会用到这两个参数。

4、点击「国内短信」,在这里可以看到自己发送短信的情况。
包括发送成功的次数、失败的次数等等。当然现在的任务是进行配置模板。

5、点击「短信内容配置」,在这里我们需要配置短信签名和短信正文。
什么是短信签名呢,拿我们收到过的短信来说:“【阿里巴巴】您的验证码为:56659,请妥善保管好,切勿告知他人 ”。这条短息中 阿里巴巴 就是短信签名。

6、点击创建短信签名,这里可以选择签名的类型。是用于公司还是APP、网站。
根据自己的情况来就可以,但是如果选择「网站」签名类型的话,需要提供备案的截屏,如果没备案的可以去操作一下。如果选择「公司」需要提供营业执照截屏。

对于没有备案的网站和营业执照的朋友,久一也帮你探索好了别的道路,可以使用 阿里云 的短信服务,不过对于没有营业执照的情况,阿里提供的短信服务只能申请验证码的功能,想一些通知用户取货、通知取货码等等通用功能是没办法申请的。

阿里短信服务网址:http://account.aliyun.com/login/login.html

下面链接是阿里云短信服务的博文,流程差不多:
http://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 AppIDint appid = 1400009099; 
// 1400开头
// 短信应用SDK AppKeyString appkey = "9ff91d87c2cd7cd0ea762f141975481d48700d70ac37470aefc60f9bad";
// 需要发送短信的手机号码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();}
}

总结:

上面就是比较实用的短信发送实战,如果发送失败,可以根据接口调用返回的result的错误代码查阅官方文档,如果按照我的步骤一步一步来应该不会出错。

至此,我们揭开了发送短信业务的什么面纱。如果你阅读完本文有所收获,还请多多转发、点赞支持。

C 3条回复 评论
安菲尔德-8号

准备三刷这节课!

发表于 2022-04-12 22:00:00
0 0
耿蕊

请问 一下,我本科就是软件工程(软件测试方向),以后也想成为软件测试工程师,目前大三即将结束,我之前是准备考研 ,也只是知道考研没有考虑具体什么方向之类的。因为软件测试是专业课 大三下才开课,我现在发现考研的学校 基本没有 软件测试方向的,都是比较热门的大数据、人工智能等研究方向。 所以 想成为软件测试工程师 是在大四时好好学习技术 然后本来毕业找工作?还是 应该考研究生(只是 我发现研究生没有研究软件测试的,也可能我没关注到) ?

发表于 2022-02-08 21:00:00
0 0
芝麻酱

看过之后很多感触,唯有谢谢最简单也最真诚

发表于 2022-01-07 23:00:00
0 0