项目需要用到发送短信进行验证、推送、通知,公司选用的是阿里大鱼短信服务,阿里家工程师封装的接口,可以说是很贴心了,下面开始我们集成短信之旅吧~
首先,我们需要先看文档: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", "15206638602"); map.put("signName", "请填写阿里的短信签名"); map.put("templateCode", "短信模板模板的ID"); map.put("templateParam", "{\"code\":\"520\"}"); //到这里短信的参数就搞定了 //下面进行的是短信的发送 SmsUtil.Senders(map); } }