阿里大于短信服务_总结_01_短信验证码接入-阿里云开发者社区

一、代码实现

1.接入配置类—Env.java

package com.ray.sms.aliyun.config;

/**@desc  : 阿里大于短信服务 接入配置
 * 
 * @author: shirayner
 * @date  : 2017年11月6日 下午6:27:53
 */
public class Env {

    //1. 此处需要替换成开发者自己的AK(在阿里云访问控制台寻找)
    public static final String ACCESSKEY_ID = "LTAIysLddrUmdw3l";
    public static final String ACCESSKEY_SECRET = "MhjTxvbJe8S4j8xaVE9fnJzaAerg4i";

    
    //2.产品名称:云通信短信API产品,开发者无需替换
    public static final String PRODUCT = "Dysmsapi";
    //产品域名,开发者无需替换
    public static final String DOMAIN = "dysmsapi.aliyuncs.com";
    
    
    //3.短信签名和模板,替换成自己的
    public static final String SIGN_NAME  = "云通信";
    public static final String TEMPLATE_CODE  = "SMS_109545088";




}

View Code

2.短信服务—ShortMessageService.java

package com.ray.sms.aliyun.service;

import java.text.SimpleDateFormat;
import java.util.Date;

import com.alibaba.fastjson.JSONObject;
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.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;
import com.ray.sms.aliyun.config.Env;

/**@desc  : 短信服务
 * 
 * @author: shirayner
 * @date  : 2017年11月6日 下午7:35:03
 */
public class ShortMessageService {

    /**
     * @desc ：1.发送短信
     *  
     * @param phoneNumber  手机号
     * @param code  验证码
     * @return
     * 
     * 
     * 
     * @throws ClientException SendSmsResponse
     */
    public static SendSmsResponse sendSms(String phoneNumber ,String code) throws ClientException {
        //1.准备好短信模板变量——验证码code
        JSONObject jsonObject=new JSONObject();
        jsonObject.put("code", code);
        String TemplateParam=jsonObject.toJSONString();

        //2.可自助调整超时时间
        System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
        System.setProperty("sun.net.client.defaultReadTimeout", "10000");

        //3.初始化acsClient,暂不支持region化
        IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", Env.ACCESSKEY_ID, Env.ACCESSKEY_SECRET);
        DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", Env.PRODUCT, Env.DOMAIN);
        IAcsClient acsClient = new DefaultAcsClient(profile);

        //4.组装请求对象-具体描述见控制台-文档部分内容
        SendSmsRequest request = new SendSmsRequest();
        //必填:待发送手机号
        request.setPhoneNumbers(phoneNumber);
        //必填:短信签名-可在短信控制台中找到
        request.setSignName(Env.SIGN_NAME);
        //必填:短信模板-可在短信控制台中找到
        request.setTemplateCode(Env.TEMPLATE_CODE);
        //可选:模板中的变量替换JSON串,如模板内容为"亲爱的${name},您的验证码为${code}"时,此处的值为
        request.setTemplateParam(TemplateParam);

        //选填-上行短信扩展码(无特殊需求用户请忽略此字段)
        //request.setSmsUpExtendCode("90997");

        //可选:outId为提供给业务方扩展字段,最终在短信回执消息中将此值带回给调用者
        request.setOutId("yourOutId");

        //5.hint 此处可能会抛出异常，注意catch
        SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);

        return sendSmsResponse;
    }


    /**
     * @desc ：2.短信发送记录查询接口
     *   用于查询短信发送的状态，是否成功到达终端用户手机
     * @param bizId  
     * @param phoneNumber
     * @return
     * @throws ClientException QuerySendDetailsResponse
     */
    public static QuerySendDetailsResponse querySendDetails(String bizId,String phoneNumber) throws ClientException {

        //可自助调整超时时间
        System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
        System.setProperty("sun.net.client.defaultReadTimeout", "10000");

        //初始化acsClient,暂不支持region化
        IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", Env.ACCESSKEY_ID, Env.ACCESSKEY_SECRET);
        DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", Env.PRODUCT, Env.DOMAIN);
        IAcsClient acsClient = new DefaultAcsClient(profile);

        //组装请求对象
        QuerySendDetailsRequest request = new QuerySendDetailsRequest();
        //必填-号码
        request.setPhoneNumber(phoneNumber);
        //可选-流水号
        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;
    }

    
}

View Code

3.验证码生成器—CheckSumBuilder.java

package com.ray.sms.aliyun.util;

import java.util.Random;

/**@desc  : 验证码工具类
 * 
 * @author: shirayner
 * @date  : 2017年11月7日 上午10:07:46
 */
public class CheckSumBuilder {
    
    /**
     * @desc ：1.随机产生字符串
     *  
     * @param length 字符串长度
     * @param type 类型 (0: 仅数字; 2:仅字符; 别的数字:数字和字符)
     * @return 
     *   String  随机串
     */
    public static String getRandomStr(int length, int type){
        String str = "";
        int beginChar = 'a';
        int endChar = 'z';
        
        // 只有数字
        if (type == 0){
            beginChar = 'z' + 1;
            endChar = 'z' + 10;
        }
        // 只有小写字母
        else if (type == 2){
            beginChar = 'a';
            endChar = 'z';
        }
        // 有数字和字母
        else{
            beginChar = 'a';
            endChar = 'z' + 10;
        }

        // 生成随机类
        Random random = new Random();
        for (int i = 0; i < length; i++){
            int tmp = (beginChar + random.nextInt(endChar - beginChar));
            // 大于'z'的是数字
            if (tmp > 'z'){
                tmp = '0' + (tmp - 'z');
            }
            str += (char) tmp;
        }

        return str;
    }

    /**
     * @desc ：2.获取6位数字验证码
     *  
     * @return 
     *   String  6位数字验证码
     */
    public static String getCheckSum() {
        return getRandomStr(6, 0);
    }
    
}

View Code

4.测试类—ShortMessageServiceTest.java

package com.ray.sms.aliyun.service;

import org.junit.Test;
import com.aliyuncs.dysmsapi.model.v20170525.QuerySendDetailsResponse;
import com.aliyuncs.dysmsapi.model.v20170525.SendSmsResponse;
import com.aliyuncs.exceptions.ClientException;
import com.ray.sms.aliyun.util.CheckSumBuilder;

/**@desc  : 
 * 
 * @author: shirayner
 * @date  : 2017年11月6日 下午7:41:46
 */
public class ShortMessageServiceTest {

    @Test
    public void testsms() throws ClientException, InterruptedException {
        //1.准备好请求参数：phoneNumber、TemplateParam
        String phoneNumber="14326756454";
        String code=CheckSumBuilder.getCheckSum();

        //2.调用接口，发短信
        SendSmsResponse response = ShortMessageService.sendSms(phoneNumber,code);
        
        //3.获取发送结果
        System.out.println("短信接口返回的数据----------------");
        System.out.println("Code=" + response.getCode());
        System.out.println("Message=" + response.getMessage());
        System.out.println("RequestId=" + response.getRequestId());
        System.out.println("BizId=" + response.getBizId());

        Thread.sleep(3000L);

        //查明细
        if(response.getCode() != null && response.getCode().equals("OK")) {
            QuerySendDetailsResponse querySendDetailsResponse = ShortMessageService.querySendDetails(response.getBizId(),phoneNumber);
            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());
        }

    }
}

View Code

二、参考资料

1.阿里短信服务API接入指南及示例

2.阿里短信服务API