前提條件

• 已注冊阿里云賬號并生成訪問密鑰（AccessKey），詳情請參見創建RAM用戶的AccessKey。

• 確保可以在本地ping通以下地址：dysmsapi.aliyuncs.com或mns.cn-hangzhou.aliyuncs.com或dybaseapi.aliyuncs.com。

• 已創建RAM用戶，并已為RAM用戶授予短信服務權限、輕量消息隊列權限。

• 已閱讀回執消息配置，了解回執消息模式、類型和配置流程。

SmsUp消息體格式

Demo下載

請參見輕量消息隊列（原MNS）消費Demo，根據您需要的開發語言，完成Demo及SDK的下載。本文后續操作以Java語言為例。

參數配置

String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");

String messageType="<MESSAGE_TYPE>";

String queueName="<QUEUE_NAME>";

完整示例

您獲取到的上行信息內容由dealMessage方法處理，您可以將需要的上行信息內容的業務邏輯寫在該方法中。

// 根據文檔中具體的消息格式進行消息體的解析
String arg = (String) contentMap.get("arg");
// 編寫您的業務代碼

arg代表回執消息體中的參數，可填寫的值為：dest_code、send_time、sequence_id、phone_number、content。

package com.alicom.mns.sample;

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;


import com.alicom.mns.tools.DefaultAlicomMessagePuller;
import com.alicom.mns.tools.MessageListener;
import com.aliyun.mns.model.Message;
import com.google.gson.Gson;

/**
 * 只能用于接收云通信的消息，不能用于接收其他業務的消息
 */
public class ReceiveDemo {

    private static Log logger=LogFactory.getLog(ReceiveDemo.class);

    static class MyMessageListener implements MessageListener{
        private Gson gson=new Gson();

        @Override
        public boolean dealMessage(Message message) {

            SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            //消息的幾個關鍵值
            System.out.println("message receiver time from mns:" + format.format(new Date()));
            System.out.println("message handle: " + message.getReceiptHandle());
            System.out.println("message body: " + message.getMessageBodyAsString());
            System.out.println("message id: " + message.getMessageId());
            System.out.println("message dequeue count:" + message.getDequeueCount());
            System.out.println("Thread:" + Thread.currentThread().getName());
            try{
                Map<String,Object> contentMap=gson.fromJson(message.getMessageBodyAsString(), HashMap.class);

                // 根據文檔中具體的消息格式進行消息體的解析
                String arg = (String) contentMap.get("arg");

                // 這里開始編寫您的業務代碼

            }catch(com.google.gson.JsonSyntaxException e){
                logger.error("error_json_format:"+message.getMessageBodyAsString(),e);
                //理論上不會出現格式錯誤的情況，所以遇見格式錯誤的消息，只能先delete，否則重新推送也會一直報錯
                return true;
            } catch (Throwable e) {
                //您自己的代碼部分導致的異常，應該return false，這樣消息不會被delete掉，而會根據策略進行重推
                return false;
            }

            //消息處理成功，返回true, SDK將調用MNS的delete方法將消息從隊列中刪除掉
            return true;
        }

    }

    public static void main(String[] args) throws Exception, ParseException {

        DefaultAlicomMessagePuller puller=new DefaultAlicomMessagePuller();

        //設置異步線程池大小及任務隊列的大小，還有無數據線程休眠時間
        puller.setConsumeMinThreadSize(6);
        puller.setConsumeMaxThreadSize(16);
        puller.setThreadQueueSize(200);
        puller.setPullMsgThreadSize(1);
        //和服務端聯調問題時開啟，平時無需開啟，消耗性能
        puller.openDebugLog(false);

        // 從本地環境變量獲取AccessKey ID和AccessKey Secret信息
        String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
        String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");

        /*
        *  將messageType和queueName替換成您需要的消息類型名稱和對應的隊列名稱
        *  云通信產品下所有的回執消息類型:
        *  1:短信回執：SmsReport，
        *  2:短信上行：SmsUp       
        *  3:國際短信回執：GlobeSmsReport
        */
        String messageType="<MESSAGE_TYPE>"; //此處應該替換成相應產品的消息類型
        String queueName="<QUEUE_NAME>"; //在云通信頁面開通相應業務消息后，就能在頁面上獲得對應的queueName，格式類似Alicom-Queue-******-SmsUp
        puller.startReceiveMsg(accessKeyId,accessKeySecret,messageType,queueName,new MyMessageListener());
    }
}

Demo運行后輸出效果如下。