配置服務端訂閱

1. 在左側導航欄，選擇消息轉發 > 服務端訂閱。

2. 在服務端訂閱頁，單擊創建訂閱。

3. 在創建訂閱對話框中，按照如下圖配置，然后單擊確定。

   
   說明

   設備上報的消息格式相關說明，請參見數據格式中的設備屬性上報、設備事件上報和設備下行指令結果內容。

接收服務端訂閱消息

本案例使用Java SDK接收服務端訂閱消息，詳細步驟請參見Java SDK接入示例。

以下Demo中涉及的參數說明，請參見AMQP客戶端接入說明。

/**
 * AMQP服務端訂閱
*/
//參數說明，請參見AMQP客戶端接入說明文檔。
String accessKey = "***";
String accessSecret = "***";
String consumerGroupId = "***";
//iotInstanceId：實例ID。
String iotInstanceId = "";
long timeStamp = System.currentTimeMillis();
//簽名方法：支持hmacmd5、hmacsha1和hmacsha256。
String signMethod = "hmacsha1";
//控制臺服務端訂閱中消費組狀態頁客戶端ID一欄將顯示clientId參數。
//建議使用機器UUID、MAC地址、IP等唯一標識等作為clientId。便于您區分識別不同的客戶端。
String clientId = "TESTClientID";

//userName組裝方法，請參見AMQP客戶端接入說明文檔。
String userName = clientId + "|authMode=aksign"
    + ",signMethod=" + signMethod
            + ",timestamp=" + timeStamp
            + ",authId=" + accessKey
            + ",iotInstanceId=" + iotInstanceId
            + ",consumerGroupId=" + consumerGroupId
            + "|";
//計算簽名，password組裝方法，請參見AMQP客戶端接入說明文檔。
String signContent = "authId=" + accessKey + "&timestamp=" + timeStamp;
String password = doSign(signContent,accessSecret, signMethod);
//接入域名，請參見AMQP客戶端接入說明文檔。
String connectionUrl = "amqps://${uid}.iot-amqp.${regionId}.aliyuncs.com:5671?amqp.idleTimeout=80000";

Hashtable<String, String> hashtable = new Hashtable<>();
hashtable.put("connectionfactory.SBCF",connectionUrl);
hashtable.put("queue.QUEUE", "default");
hashtable.put(Context.INITIAL_CONTEXT_FACTORY, "org.apache.qpid.jms.jndi.JmsInitialContextFactory");
Context context = new InitialContext(hashtable);
ConnectionFactory cf = (ConnectionFactory)context.lookup("SBCF");
Destination queue = (Destination)context.lookup("QUEUE");
// Create Connection
Connection connection = cf.createConnection(userName, password);
((JmsConnection) connection).addConnectionListener(myJmsConnectionListener);
// Create Session
// Session.CLIENT_ACKNOWLEDGE: 收到消息后，需要手動調用message.acknowledge()。
// Session.AUTO_ACKNOWLEDGE: SDK自動ACK（推薦）。
Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
connection.start();
// Create Receiver Link
MessageConsumer consumer = session.createConsumer(queue);
consumer.setMessageListener(messageListener);
}

private static MessageListener messageListener = new MessageListener() {
    @Override
    public void onMessage(Message message) {
        try {
            //1.收到消息之后一定要ACK。
            // 推薦做法：創建Session選擇Session.AUTO_ACKNOWLEDGE，這里會自動ACK。
            // 其他做法：創建Session選擇Session.CLIENT_ACKNOWLEDGE，這里一定要調message.acknowledge()來ACK。
            // message.acknowledge();
            //2.建議異步處理收到的消息，確保onMessage函數里沒有耗時邏輯。
            // 如果業務處理耗時過程過長阻塞住線程，可能會影響SDK收到消息后的正?；卣{。
            executorService.submit(() -> processMessage(message));
        } catch (Exception e) {
            logger.error("submit task occurs exception ", e);
        }
    }
};

/**
 * 在這里處理您收到消息后的具體業務邏輯。
*/
private static void processMessage(Message message) {
    try {
        byte[] body = message.getBody(byte[].class);
        String content = new String(body);
        String topic = message.getStringProperty("topic");
        String messageId = message.getStringProperty("messageId");
        System.out.println("AMQP receive message"
                           + ", topic = " + topic
                           + ", messageId = " + messageId
                           + ", content = " + content);
    } catch (Exception e) {
        logger.error("processMessage occurs error ", e);
    }
}

private static JmsConnectionListener myJmsConnectionListener = new JmsConnectionListener() {
    /**
     * 連接成功建立。
     */
    @Override
    public void onConnectionEstablished(URI remoteURI) {
        logger.info("onConnectionEstablished, remoteUri:{}", remoteURI);
    }

    /**
     * 嘗試過最大重試次數之后，最終連接失敗。
     */
    @Override
    public void onConnectionFailure(Throwable error) {
        logger.error("onConnectionFailure, {}", error.getMessage());
    }

    /**
      * 連接中斷。
      */
    @Override
    public void onConnectionInterrupted(URI remoteURI) {
        logger.info("onConnectionInterrupted, remoteUri:{}", remoteURI);
    }

    /**
     * 連接中斷后又自動重連上。
     */
    @Override
    public void onConnectionRestored(URI remoteURI) {
        logger.info("onConnectionRestored, remoteUri:{}", remoteURI);
    }

    @Override
    public void onInboundMessage(JmsInboundMessageDispatch envelope) {}

    @Override
    public void onSessionClosed(Session session, Throwable cause) {}

    @Override
    public void onConsumerClosed(MessageConsumer consumer, Throwable cause) {}

    @Override
    public void onProducerClosed(MessageProducer producer, Throwable cause) {}
};

/**
 * 計算簽名，password組裝方法，請參見AMQP客戶端接入說明文檔。
 */
private static String doSign(String toSignString, String secret, String signMethod) throws Exception {
    SecretKeySpec signingKey = new SecretKeySpec(secret.getBytes(), signMethod);
    Mac mac = Mac.getInstance(signMethod);
    mac.init(signingKey);
    byte[] rawHmac = mac.doFinal(toSignString.getBytes());
    return Base64.encodeBase64String(rawHmac);
}

日志打印出如下訂閱消息，表示服務端訂閱消息成功。

后續步驟

設備運行時