记录移动云MAS短信平台发送模板短信+获取回执状态

直接上代码，清晰明了(所有发送短信代码是写在一个工具类)，也参考了网上一些博主的文章，非常感谢，以下内容只是记录平时做东西的内容，如有不正确的地方，欢迎指正。

PS:（写在前面）需要注意的几个点：

（1）需要先在mas平台上配置相关信息和接口（主页-管理-接口管理），https请求需要将短信平台上的短信接口创建为http协议模式，否则请求失败；http请求同理，只要短信接口的用户名、密码和协议对应正确，一般没有太大问题；

（2）如果是发送模板短信需要先申请短信模板，且传入参数必须和模板中变量所包含的类型一致，否则mas平台上数据校验无法通过（有条件还是获取一下回执报告，因为有时候即使响应状态返回success，最后没有收到短信，进入平台查看可以看到其实回执状态报错，并没有发送成功）;

（3）如果短信模板中的变量长度不能满足需要，可以联系客户经理申请特殊变量，特殊变量一个模板中可以使用两次；

  (4)https短信接口文档中写得很清楚：【请客户侧忽略证书校验，移动侧不提供证书秘钥】，所以在做post请求的时候一定要记得【忽略证书校验】，否则请求失败，返回值为空；http请求不用管。

（5）短信响应状态成功返回的是：{"msgGroup":"0906163415000000332084","rspcod":"success","success":true}，有错误的时候是：{ "msgGroup": "",    "rspcod": "InvalidUsrOrPwd",    "success": false}

（6）短信发送成功回执状态返回的是“[]”，有错误的时候是：[{"errorCode":"CM:2007","mobile":"13888888888","msgGroup":"0906144506000001364223","receiveDate":"20210906244506","reportStatus":"CM:2007","submitDate":"20210906144506"}]

（7）上面说的其实平台上和提供的文档中基本都有说明，多看提供的接口文档，对实现自己想要的功能有帮助！！！

 

 

1.SMSUtil.java

a.通过https请求发送模板短信（网上很多的都是用http方式请求，只不过获取回执状态需要自己搭建http服务，太菜了感觉比较麻烦就采用了https请求，可以自己主动获取回执报告，这个因人而异）

    /**
     * 云MAS-发送模板短信(https)
     *
     * @param mobiles 手机号
     * @param templateId 模板id
     * @param param 参数列表
     * @return
     * @throws UnsupportedEncodingException
     */
    public static  AjaxResult sendTemplateSms(String mobiles, String templateId, List<String> param) throws UnsupportedEncodingException {
        apId="xxx";//用户名
        secretKey="xxx";//密码
        ecName = "xxx";    //集团名称
        sign = "xxx";    //网关签名编码
        addSerial = "";    //拓展码 填空
        templateurl = "https://112.35.10.201:28888/sms/tmpsubmit";//和http请求地址不一样  http://112.35.1.155:1992/sms/tmpsubmit
 
        //发送短信--start--
        String params = null;
        if(param != null){
            params = JSON.toJSONString(param.toArray());
        }else{
            params = "[]";
        }
        SendRequest submitReq = new SendRequest();
        submitReq.setApId(apId);
        submitReq.setEcName(ecName);
        submitReq.setSecretKey(secretKey);
        submitReq.setParams(params);
        submitReq.setMobiles(mobiles);
        submitReq.setSign(sign);
        submitReq.setAddSerial(addSerial);
        submitReq.setTemplateId(templateId);

        StringBuffer stringBuffer = new StringBuffer();
        stringBuffer.append(submitReq.getEcName());
        stringBuffer.append(submitReq.getApId());
        stringBuffer.append(submitReq.getSecretKey());
        stringBuffer.append(submitReq.getTemplateId());
        stringBuffer.append(submitReq.getMobiles());
        stringBuffer.append(submitReq.getParams());
        stringBuffer.append(submitReq.getSign());
        stringBuffer.append(submitReq.getAddSerial());
        String encode = "";
        try {
            //接口要求参数为MD5加密后的值
            submitReq.setMac(Md5Utils.hash(stringBuffer.toString()));
            String reqText = JSON.toJSONString(submitReq);
            //base64编码
            encode =new String(Base64.encodeBase64Chunked(reqText.getBytes("UTF-8")));  //有中文时使用UTF-8
        } catch (UnsupportedEncodingException e1) {
            e1.printStackTrace();
        }
        String resStr = "";
        try {
            resStr = new String(HttpUtils.sendPostTrust(templateurl,encode,"utf-8","POST"));//https链接
        } catch (Exception e) {
            e.printStackTrace();
        }
        //发送短信--end--

        //响应状态、回执状态处理--start--
        SendResponse sendRes = JSON.parseObject(resStr,SendResponse.class);//响应状态
        String receiptReport=getReport(apId,secretKey,ecName);//回执状态
        String errorCode="";
        if(receiptReport!="[]"){
            JSONArray jsonArray= JSONArray.parseArray(receiptReport);
            if(receiptReport.contains("errorCode")){
                for(int index=0;index<jsonArray.size();index++){
                    JSONObject jsonObject = jsonArray.getJSONObject(index);
                    if(jsonObject.getString("mobile").equals(mobiles)) {
                        errorCode=jsonObject.get("errorCode").toString();
                    }
                }
            }
        }
        else{
           errorCode="";
        }
        if(sendRes.getSuccess() && !"".equals(sendRes.getMsgGroup()) && "success".equals(sendRes.getRspcod())){
            switch (sendRes.getRspcod()) {
                case "success":
                    if (errorCode != null && errorCode != "") {
                        return AjaxResult.error(11, "其他错误：" + errorCode+",请联系管理员!");
                    } else {
                        return AjaxResult.error(0, "发送成功");
                    }
                case "IllegalMac ":
                    return AjaxResult.error(1, "mac校验不通过");
                case "IllegalSignId ":
                    return AjaxResult.error(2, "无效的签名编码");
                case "InvalidMessage ":
                    return AjaxResult.error(3, "非法消息，请求数据解析失败");
                case "InvalidUsrOrPwd ":
                    return AjaxResult.error(4, "非法用户名/密码");
                case "NoSignId ":
                    return AjaxResult.error(5, "未匹配到对应的签名信息");
                case "TooManyMobiles ":
                    return AjaxResult.error(6, "手机号数量超限,应≤5000");
                default:
                    return AjaxResult.error(-1, "系统异常");
            }
        }
        else{
            return AjaxResult.error(-2,"请求异常");
        }
        //响应状态、回执状态处理--end--
    }

    //获取状态报告
    public static String getReport(String apId,String secretKey,String ecName){
        String reporturl = "https://112.35.10.201:28888/sms/report";

        SendRequest submitReq = new SendRequest();
        submitReq.setApId(apId);
        submitReq.setEcName(ecName);
        submitReq.setSecretKey(secretKey);

        StringBuffer stringBuffer = new StringBuffer();
        stringBuffer.append(submitReq.getEcName());
        stringBuffer.append(submitReq.getApId());
        stringBuffer.append(submitReq.getSecretKey());
        stringBuffer.append(submitReq.getTemplateId());
        String encode = "";
        try {
            //接口要求参数为MD5加密后的值
            submitReq.setMac(Md5Utils.hash(stringBuffer.toString()));
            String reqText = JSON.toJSONString(submitReq);
            //base64编码
            encode =new String(Base64.encodeBase64Chunked(reqText.getBytes("UTF-8")));  //有中文时使用UTF-8
        } catch (UnsupportedEncodingException e1) {
            e1.printStackTrace();
        }
        String receiptReport = "";
        try {
            receiptReport = new String(HttpUtils.sendPostTrust(reporturl,encode,"utf-8","POST"));//https链接

        } catch (Exception e) {
            e.printStackTrace();
        }
        return receiptReport;
    }

 

2.HttpUtils.java---->sendPostTrust

   //添加信任主机
    private static void trustAllHosts() {
        // 创建不验证证书链的信任管理器 这里使用的是x509证书
        TrustManager[] trustAllCerts = new TrustManager[]{new TrustAnyTrustManager() {
            public java.security.cert.X509Certificate[] getAcceptedIssuers() {
                return new java.security.cert.X509Certificate[]{};
            }

            public void checkClientTrusted(X509Certificate[] chain, String authType) {
            }

            public void checkServerTrusted(X509Certificate[] chain, String authType) {
            }
        }};
        // 安装所有信任的信任管理器
        try {
            SSLContext sc = SSLContext.getInstance("TLS");
            sc.init(null, trustAllCerts, new java.security.SecureRandom());
            //HttpsURLConnection通过SSLSocket来建立与HTTPS的安全连接，SSLSocket对象是由SSLSocketFactory生成的。
            HttpsURLConnection.setDefaultSSLSocketFactory(sc.getSocketFactory());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    /**
     *  发送post 数据并忽略证书校验
     * @param urls
     * @return
     */
    public static String sendPostTrust(String urls, String param, String contentType, String method) {
        StringBuffer sb=new StringBuffer();
        DataOutputStream out = null;
        BufferedReader responseReader = null;
        InputStream in1 = null;
        try {
            trustAllHosts();
            // 创建url资源
            URL url = new URL(urls);
            // 建立http连接
            HttpsURLConnection conn = (HttpsURLConnection) url.openConnection();
            conn.setHostnameVerifier(DO_NOT_VERIFY);
            // 设置不用缓存
            conn.setUseCaches(false);
            // 设置允许输出
            conn.setDoOutput(true);
            // 设置允许输入
            conn.setDoInput(true);
            // 设置传递方式
            conn.setRequestMethod(method);
            //System.out.println(conn.getRequestMethod());
            // 设置维持长连接
            conn.setRequestProperty("Connection", "Keep-Alive");
            // 设置文件字符集:
            conn.setRequestProperty("Charset", "UTF-8");
            // 转换为字节数组
//            byte[] data = (param).getBytes();
//            // 设置文件长度
//            conn.setRequestProperty("Content-Length", String.valueOf(data.length));
            // 设置文件类型:
            conn.setRequestProperty("Content-Type", contentType);
            // 开始连接请求
            conn.connect();
            out = new DataOutputStream(conn.getOutputStream());
            // 写入请求的字符串
            out.writeBytes(param);
            out.flush();

            //System.out.println(conn.getResponseCode());

            // 请求返回的状态
            if (HttpURLConnection.HTTP_OK == conn.getResponseCode()) {
                System.out.println("连接成功");
                // 请求返回的数据
                in1 = conn.getInputStream();
                String readLine;
                responseReader = new BufferedReader(new InputStreamReader(in1));
                while((readLine=responseReader.readLine()) != null){
                    sb.append(readLine).append("\n");
                }
            } else {
                System.out.println("error++");
            }
        } catch (Exception e) {

        } finally {
            try {
                if (null != responseReader)
                    responseReader.close();
                if (null != in1)
                    in1.close();
            } catch(Exception e) {}
            try {
                out.close();
            } catch(Exception e) {}
        }

        return sb.toString();

    }