项目需要用到发送短信进行验证、推送、通知,公司选用的是阿里大鱼短信服务,阿里家工程师封装的接口,可以说是很贴心了,下面开始我们集成短信之旅吧~
首先,我们需要先看文档:https://help.aliyun.com/document_detail/55284.html?spm=a2c4g.11186623.6.557.Kspbq8
从文档上可以看出,我们提交个各项申请后会得到的信息有:AccessKeyId 、AccessKeySecret、短信签名以及短信模板(即具体发送的短信内容)。
编写工具类
在编写之前我们需要下载光网提供的sdk:https://help.aliyun.com/document_detail/55359.html?spm=a2c4g.11186623.2.8.5MTyTB
好,拿到这些信息后,接下来我们就开始编写发送短信的工具类:
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.dysmsapi.model.v20170525.QuerySendDetailsRequest;
import com.aliyuncs.dysmsapi.model.v20170525.QuerySendDetailsResponse;
import com.aliyuncs.dysmsapi.model.v20170525.SendSmsRequest;
import com.aliyuncs.dysmsapi.model.v20170525.SendSmsResponse;
import com.aliyuncs.dysmsapi.transform.v20170525.SendSmsResponseUnmarshaller;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;
import java.nio.charset.Charset;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;
import java.util.UUID;
public class SmsUtil {
//产品名称:云通信短信API产品,开发者无需替换
static final String product = "Dysmsapi";
//产品域名,开发者无需替换
static final String domain = "dysmsapi.aliyuncs.com";
// TODO 此处需要替换成开发者自己的AK(在阿里云访问控制台寻找)
static final String accessKeyId = "这里填写你的AccessKeyId";
static final String accessKeySecret = "这里填写你的AccessKeySecret";
/**
* 下面这个方法只需要传进去一个Map就可以进行短信的发送操作
* 调用该方法必须给这个方法的参数map put进去下面四个参数
* map的key说明:
* number:收信人的手机号
* signName:短信签名
* templateCode:短信模板模板的ID
* templateParam:模板中的变量以Json的形式赋值,例如:"{\"name\":\"Tom\", \"code\":\"123\"}"
* 只发送一个参数时就传一个,例如"{\"code\":\"123\"}"-----》map.put("templateParam","{\"code\":\"123\"}")
*
*
*/
public static void Senders(Map<String, Object> map) throws ClientException{
//可自助调整超时时间
System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
System.setProperty("sun.net.client.defaultReadTimeout", "10000");
//初始化acsClient,暂不支持region化
IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret);
DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);
IAcsClient acsClient = new DefaultAcsClient(profile);
//组装请求对象-具体描述见控制台-文档部分内容
SendSmsRequest request = new SendSmsRequest();
//必填:待发送手机号
request.setPhoneNumbers((String) map.get("number"));
//必填:短信签名-可在短信控制台中找到
request.setSignName((String) map.get("signName"));
//必填:短信模板-可在短信控制台中找到
request.setTemplateCode((String) map.get("templateCode"));
//可选:模板中的变量替换JSON串,如模板内容为"亲爱的${name},您的验证码为${code}"时,此处的值为
request.setTemplateParam((String) map.get("templateParam"));
//选填-上行短信扩展码(无特殊需求用户请忽略此字段)
//request.setSmsUpExtendCode("90997");
//可选:outId为提供给业务方扩展字段,最终在短信回执消息中将此值带回给调用者
/* request.setOutId("yourOutId");*/
//hint 此处可能会抛出异常,注意catch
try {
SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
System.out.println("短信接口返回的数据----------------");
System.out.println("Code=" + sendSmsResponse.getCode());
System.out.println("Message=" + sendSmsResponse.getMessage());
System.out.println("RequestId=" + sendSmsResponse.getRequestId());
System.out.println("BizId=" + sendSmsResponse.getBizId());
Thread.sleep(1000L);
//查明细
if(sendSmsResponse.getCode() != null && sendSmsResponse.getCode().equals("OK")) {
QuerySendDetailsResponse querySendDetailsResponse = querySendDetails(sendSmsResponse.getBizId());
System.out.println("短信明细查询接口返回数据----------------");
System.out.println("Code=" + querySendDetailsResponse.getCode());
System.out.println("Message=" + querySendDetailsResponse.getMessage());
int i = 0;
for(QuerySendDetailsResponse.SmsSendDetailDTO smsSendDetailDTO : querySendDetailsResponse.getSmsSendDetailDTOs())
{
System.out.println("SmsSendDetailDTO["+i+"]:");
System.out.println("Content=" + smsSendDetailDTO.getContent());
System.out.println("ErrCode=" + smsSendDetailDTO.getErrCode());
System.out.println("OutId=" + smsSendDetailDTO.getOutId());
System.out.println("PhoneNum=" + smsSendDetailDTO.getPhoneNum());
System.out.println("ReceiveDate=" + smsSendDetailDTO.getReceiveDate());
System.out.println("SendDate=" + smsSendDetailDTO.getSendDate());
System.out.println("SendStatus=" + smsSendDetailDTO.getSendStatus());
System.out.println("Template=" + smsSendDetailDTO.getTemplateCode());
}
System.out.println("TotalCount=" + querySendDetailsResponse.getTotalCount());
System.out.println("RequestId=" + querySendDetailsResponse.getRequestId());
}
} catch (Exception e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
public static QuerySendDetailsResponse querySendDetails(String bizId) throws ClientException {
//可自助调整超时时间
System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
System.setProperty("sun.net.client.defaultReadTimeout", "10000");
//初始化acsClient,暂不支持region化
IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret);
DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);
IAcsClient acsClient = new DefaultAcsClient(profile);
//组装请求对象
QuerySendDetailsRequest request = new QuerySendDetailsRequest();
//必填-号码
request.setPhoneNumber("15000000000");
//可选-流水号
request.setBizId(bizId);
//必填-发送日期 支持30天内记录查询,格式yyyyMMdd
SimpleDateFormat ft = new SimpleDateFormat("yyyyMMdd");
request.setSendDate(ft.format(new Date()));
//必填-页大小
request.setPageSize(10L);
//必填-当前页码从1开始计数
request.setCurrentPage(1L);
//hint 此处可能会抛出异常,注意catch
QuerySendDetailsResponse querySendDetailsResponse = acsClient.getAcsResponse(request);
return querySendDetailsResponse;
}
public static void main(String[] args) throws ClientException, InterruptedException {
//发短信
Map<String, Object> map = new HashMap<>();//用于设置发送短信的参数
map.put("number", "发送目标的手机号");
map.put("signName", "请填写阿里的短信签名");
map.put("templateCode", "短信模板模板的ID");
map.put("templateParam", "{\"code\":\"填写验证码,后面的\不要忘记加上\"}");
//到这里短信的参数就搞定了
//下面进行的是短信的发送
SmsUtil.Senders(map);
}
}