设备连接物联网平台后,数据直接上报至物联网平台。平台上的数据可以通过AMQP通道流转至您的服务器。这一步中,我们将配置AMQP服务端订阅功能。您的服务器可以通过接入AMQP SDK,接收设备数据。

背景信息

服务端订阅设备消息流程图。iot

操作步骤

  1. 物联网平台控制台中,为产品配置服务端订阅。
    1. 在左侧导航栏,选择规则引擎 > 服务端订阅
    2. 服务端订阅页的订阅列表页签下,单击创建订阅
    3. 创建订阅对话框中,完成订阅配置,单击确认
      消息类型 说明
      设备上报消息 包括设备上报的自定义数据和物模型数据(包括属性上报、事件上报、属性设置响应和服务调用响应)。
      设备状态变化通知 指当产品下设备的状态发生变化时,系统发出的通知消息。例如,设备上下线消息。
      设备生命周期变更 包括设备创建、删除、禁用和启用的通知消息。
      物模型历史数据上报 设备上报的属性和事件历史数据。
      固件升级状态通知 固件升级成功或失败的通知消息。
      网关发现子设备上报 网关可以将发现的子设备信息上报给物联网平台。需要网关上的应用程序支持。

      网关产品特有消息类型。

      设备拓扑关系变更 指子设备和网关之间的拓扑关系建立和解除消息。

      网关产品特有消息类型。

  2. AMQP客户端接入物联网平台。
    以下示例使用Apache Qpid JMS客户端接入物联网平台。请访问Qpid JMS 0.47.0
    • 添加Maven依赖。
      <!-- amqp 1.0 qpid client -->
       <dependency>
         <groupId>org.apache.qpid</groupId>
         <artifactId>qpid-jms-client</artifactId>
         <version>0.47.0</version>
       </dependency>
       <!-- util for base64-->
       <dependency>
         <groupId>commons-codec</groupId>
        <artifactId>commons-codec</artifactId>
        <version>1.10</version>
      </dependency>
    • 编辑JMS客户端接入物联网平台并接收消息的代码。

      代码示例如下:

      import java.net.URI;
      import java.util.Hashtable;
      import javax.crypto.Mac;
      import javax.crypto.spec.SecretKeySpec;
      import javax.jms.Connection;
      import javax.jms.ConnectionFactory;
      import javax.jms.Destination;
      import javax.jms.Message;
      import javax.jms.MessageConsumer;
      import javax.jms.MessageListener;
      import javax.jms.MessageProducer;
      import javax.jms.Session;
      import javax.naming.Context;
      import javax.naming.InitialContext;
      import org.apache.commons.codec.binary.Base64;
      import org.apache.qpid.jms.JmsConnection;
      import org.apache.qpid.jms.JmsConnectionListener;
      import org.apache.qpid.jms.message.JmsInboundMessageDispatch;
      import org.slf4j.Logger;
      import org.slf4j.LoggerFactory;
      
      public class AmqpJavaClientDemo {
      
          private final static Logger logger = LoggerFactory.getLogger(AmqpJavaClientDemo.class);
      
          public static void main(String[] args) throws Exception {
              //参数说明,请参见:AMQP客户端接入说明。
              String accessKey = "${YourAccessKeyID}";
              String accessSecret = "${YourAccessKeySecret}";
              String consumerGroupId = "${YourConsumerGroupId}";
              long timeStamp = System.currentTimeMillis();
              //签名方法:支持hmacmd5,hmacsha1和hmacsha256
              String signMethod = "hmacsha1";
              //控制台服务端订阅中消费组状态页客户端ID一栏将显示clientId参数。
              //建议使用机器UUID、MAC地址、IP等唯一标识等作为clientId。便于您区分识别不同的客户端。
              String clientId = "${YourClientId}";
      
              //UserName组装方法,请参见上一篇文档:AMQP客户端接入说明。
              String userName = clientId + "|authMode=aksign"
                  + ",signMethod=" + signMethod
                  + ",timestamp=" + timeStamp
                  + ",authId=" + accessKey
                  + ",consumerGroupId=" + consumerGroupId
                  + "|";
              //password组装方法,请参见上一篇文档:AMQP客户端接入说明。
              String signContent = "authId=" + accessKey + "&timestamp=" + timeStamp;
              String password = doSign(signContent,accessSecret, signMethod);
              //按照qpid-jms的规范,组装连接URL。
              String connectionUrl = "failover:(amqps://${uid}.iot-amqp.${regionId}.aliyuncs.com:5671?amqp.idleTimeout=80000)"
                  + "?failover.reconnectDelay=30";
      
              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 {
                      byte[] body = message.getBody(byte[].class);
                      String content = new String(body);
                      String topic = message.getStringProperty("topic");
                      String messageId = message.getStringProperty("messageId");
                      logger.info("receive message"
                          + ", topic = " + topic
                          + ", messageId = " + messageId
                          + ", content = " + content);
                      //如果创建Session选择的是Session.CLIENT_ACKNOWLEDGE,这里需要手动ACK。
                      //message.acknowledge();
                      //如果要对收到的消息做耗时的处理,请异步处理,确保这里不要有耗时逻辑。
                  } catch (Exception e) {
                      e.printStackTrace();
                  }
              }
          };
      
          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);
          }
      }