阿里巴巴通信的实现(短信接口调用)

      前段时间因客户要求,平台需要集成一发短信的功能,仔细看了一番,最后还是决定使用阿里云通信的服务,虽然只是简单的调用第三方接口,但是还是有一番曲折在其中,现在与大家分享一下。

----------------------------------------------------------------------------------------------------------------------------------------------------------------------------

      1.首先使用阿里云的服务当然免不了开通,注册账户,等等,大家懂得,支付宝一键搞定,然后去阿里云官网开通云通信服务,里面有详细的流程,这里就不一一列举了。

      2.引入sdk库,下载地址https://help.aliyun.com/document_detail/55359.html?spm=a2c4g.11186623.2.8.1d675777e3ClES;当然也有maven的引入方式,这里本人因项目原因并没有使用maven管理,所以不在此赘述。

     3.当把sdk库引入以后,我们可以写一个工具类,随便取个名字。

/**
 * @ClassName:MessageSend
 * @Description:发送短信的工具类,阿里云第三方运用,需要申请账号,并申请模板
 * @author HuangXi
 * @date: 日期:2018年7月30日 时间:上午11:25:14
 */
public class MessageSend {
	static final String product = "Dysmsapi";
    //产品域名,开发者无需替换
    static final String domain = "dysmsapi.aliyuncs.com";

    // TODO 此处需要替换成开发者自己的AK(在阿里云访问控制台寻找)
    static final String accessKeyId = "***************";
    static final String accessKeySecret = "*******************";

    /**
     * 
     * @Description: 发短信
     *
     * @author HuangXi
     * @date: 日期:2018年7月30日 下午1:51:23
     * @return
     * @throws ClientException
     */
    public static SendSmsResponse sendSms(HSUumsBaseUser user,String content) 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();
        //必填:待发送手机号
        //因为本人把手机号存在了每个user对象中,固传入user对象来取
        String phone = user.getUserTel();
        request.setPhoneNumbers(phone);
        //必填:短信签名-可在短信控制台中找到
        request.setSignName("短信签名需要自己申请");
        //必填:短信模板-可在短信控制台中找到
        request.setTemplateCode("短信模板账号需要自己申请,如:SMS_8888888");
        //可选:模板中的变量替换JSON串,如模板内容为"尊敬的${name},您的任务为${content}"时,此处的值为
        request.setTemplateParam("{\"name\":\""+user.getUserName()+"\", \"content\":\""+content+"\"}");

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

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

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

        return sendSmsResponse;
    }


    /**
     * 
     * @Description:查询短信发送详情
     *
     * @author HuangXi
     * @date: 日期:2018年7月30日 下午1:50:56
     * @param bizId
     * @return
     * @throws ClientException
     */
    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();
        //必填-号码,有需要可以扩展为号码参数
        //一样可以扩展为号码,传入user对象等,可以在数据库建表把短信发送日志存储进去,本人因为
        //没有需求,固省略了该步骤
        request.setPhoneNumber("88888888888888");
        //可选-流水号
        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;
    }
    
  //查明细,可以根据发送的号码和id来添加日志,和上面方法一样,如无必要可以不使用
    /*if(response.getCode() != null && response.getCode().equals("OK")) {
        QuerySendDetailsResponse querySendDetailsResponse = MessageSend.querySendDetails(response.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());
    }
    */
}

   4.当改工具类写好以后,你随便在业务代码中都能够调用。

            try {
                    //发短信
                    SendSmsResponse response = MessageSend.sendSms(user,content);
                    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());
                } catch (Exception e) {
                    // TODO Auto-generated catch block
                    e.printStackTrace();
                }

5.当然,这只是单条短信发送的方式,阿里云通信中还有批量发送的方法,具体就是改变发短信方法中的对象,这里也不赘述了,有兴趣的朋友可以自行去阿里云api查看。

你可能感兴趣的:(阿里巴巴通信的实现(短信接口调用))