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

659 阅读6分钟
原文链接: mp.weixin.qq.com

阅读文本大概需要 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 AppIDint appid = 1400009099; // 1400开头// 短信应用SDK AppKeyString 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项目聚集地」回复:「技术文章 」,即可获取更改实战教程、实用教程,我们明天见!

1.  Java 学习方向的 相关书籍 推荐!

2.  最近面试 Java 后端开发的感受!

3. 想和你聊聊 前后端分离 !

4. 什么是消息队列?