阿里云新版SDK的基础使用
前言:最近在做开发中因为需要用到短信验证,在进行选择后选择了阿里云的短信验证平台(付费:简短普通短信价格在0.04元一条)。由于官网的帮助文档过于详细无法快速找到重点内容,并且SDK新旧版有较大区别,自己走了很多弯路,借此机会写一份完整的操作步骤以便于没有使用的的新手也可以快速上手。
1.进入阿里云短信服务
首先搜索阿里云官网进入开发者社区,直接搜索“短信服务控制器”。
2.数据准备工作(先冲1块,没钱的话运行会报错)
进入控制台主页后我们点击右侧AccessKey
点击创建AccessKey得到自己的Id和密码(后面要用到,切记不要泄露)
返回到主页选择左侧的国内消息,对我们的短信格式进行设置,审核一般要半个小时还是比较久的,所以尽量一次把格式完成。
签名管理就是我们收到验证短信开头常见的【xx平台】,不能取名过于广泛例如:【短信验证】,【验证测试】这种都同过不了审核。可以借鉴已有的平台取名:【么得钱花】,【啊外云】。
模板管理就是短信的具体内容,签名和模板添加的时候他都会描述的非常详细。
3.Jar包的下载及导入
点击控制器主页左侧的帮助文档我们可以进入短信服务帮助文档的主页。最左侧我们就可以看到SDK参考(新版)。官方手册中提供两种方式引入Jar:
-
通过Maven添加依赖(推荐)
-
导入Jar包
通过Maven比较简单我们直接复制文档中的依赖就可以了,这里详细说一下都需要导入哪些Jar包。
aliyu-java-sdk-core 这仅仅是核心库,如果我们只导入这一个包就去撸代码的话最后你会发现报错java.lang.NoClassDefFoundError: com/google/gson/JsonParser
找不到com.google.gson.JsonParser类- -由于会用到Json的解析,我们还需要下载导入一个google的gson包。
4.话不多说开始搞代码(画重点)
先创建工程,导入了上述的两个包。
以下是我的代码给大家看下了解下哪里需要改,注意这里的代码都不需要自己手写:
20-27行是生成6位数验证码的方法,最后拼接成JSON数据的形式存放到TemplateParam中,文中代码最后就形成了{“code”:“xxxxxx”}的形式,在短信中以${code}取出。样例模板内容:
※前面说了这些代码不需要去手写,那么代码是怎么来的呢?这也是新版SDK最强大的地方!
在控制台主页右上角,有一个OpenAPI Explorer,点击进去我们就可以看到阿里云提供给我们的一个编译环境。我们只需要在中间的表单中填写相应数据,就会自动生成对应代码,我们唯一需要做的就是生成短信中的动态内容,例如上文所述的随机6位数验证码。
我们在使用AccessKey的时候他会提醒你直接使用自己的不安全,建议你去创建RAM用户。也就是虚拟用户,你可以通过虚拟用户创建对应的AccessKey来使用相对安全。并且数据中的电话号码我们也是从页面接收过来并非写死的,最后我把一份样板代码贴在下面给大家复制用。
import com.aliyuncs.CommonRequest;
import com.aliyuncs.CommonResponse;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.profile.DefaultProfile;
public class SendSms{
public static void main(String[] args) {
//随机生成六位随机数
StringBuffer stringBuffer=new StringBuffer();
for (int x=0;x<=5;x++) {
int random = (int) (Math.random() * (10 - 1));
stringBuffer.append(random);
}
String string = stringBuffer.toString();
int i = Integer.parseInt(string);
DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", "你的AccessKeyId", "你的AccessKey的密码");
IAcsClient client = new DefaultAcsClient(profile);
CommonRequest request = new CommonRequest();
request.setMethod(MethodType.POST);
request.setDomain("dysmsapi.aliyuncs.com");
request.setVersion("2017-05-25");
request.setAction("SendSms");
request.putQueryParameter("RegionId", "cn-hangzhou");
request.putQueryParameter("PhoneNumbers", "要发送验证码的手机号");
request.putQueryParameter("SignName", "签名名称");
request.putQueryParameter("TemplateCode", "模板CODE");
request.putQueryParameter("TemplateParam", "{\"code\":" + i + "}");
try {
CommonResponse response = client.getCommonResponse(request);
System.out.println(response.getData());
} catch (ServerException e) {
e.printStackTrace();
} catch (ClientException e) {
e.printStackTrace();
}
}
}
- 希望本篇文章对大家有帮助,有问题的话欢迎指出和评论探讨!