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

背景信息

通过AMQP服务端订阅获取设备消息流程如下图所示。AMQP

操作步骤

  1. 登录物联网平台控制台
  2. 实例概览页,单击公共实例
    入门教程-公共实例
  3. 为消息消费端配置消费组身份,用于您的服务器通过监听消费组获取消息。
    1. 在左侧导航栏,选择规则引擎 > 服务端订阅,单击消费组列表页签。
    2. 单击创建消费组
    3. 创建消费组对话框中,设置消费组名称为路灯消费组,单击确认
  4. 为路灯设备所属产品配置服务端订阅,用于您的服务器直接订阅产品下多种类型的消息 。
    1. 在左侧导航栏,选择规则引擎 > 服务端订阅
    2. 服务端订阅页面的订阅列表页签下,单击创建订阅
    3. 创建订阅对话框,设置参数后单击确认
      充电宝机柜-创建订阅
      参数 说明
      产品 选择路灯
      订阅类型 选择AMQP
      消费组 选择上一步创建的路灯消费组
      推送消息类型 选择设备上报消息
  5. AMQP客户端接入物联网平台。
    以下示例使用Apache Qpid JMS客户端接入物联网平台,请访问Qpid JMS 0.47.0下载客户端和查看使用说明。
    1. 添加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>
              <dependency>
                  <groupId>org.slf4j</groupId>
                  <artifactId>slf4j-simple</artifactId>
                  <version>1.7.25</version>
                  <scope>compile</scope>
              </dependency>
    2. 编辑JMS客户端接入物联网平台并接收消息的代码。
      import java.net.URI;
      import java.util.Hashtable;
      import java.util.concurrent.ExecutorService;
      import java.util.concurrent.LinkedBlockingQueue;
      import java.util.concurrent.ThreadPoolExecutor;
      import java.util.concurrent.TimeUnit;
      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);
      
          //业务处理异步线程池,线程池参数可以根据您的业务特点调整,或者您也可以用其他异步方式处理接收到的消息。
          private final static ExecutorService executorService = new ThreadPoolExecutor(
              Runtime.getRuntime().availableProcessors(),
              Runtime.getRuntime().availableProcessors() * 2, 60, TimeUnit.SECONDS,
              new LinkedBlockingQueue<>(50000));
      
          public static void main(String[] args) throws Exception {
              //参数说明,请参见AMQP客户端接入说明文档。
              String accessKey = "${YourAccessKey}";
              String accessSecret = "${YourAccessSecret}";
              String consumerGroupId = "${YourConsumerGroupId}";
              //iotInstanceId:企业版实例请填写实例ID,公共实例请填空字符串""。
              String iotInstanceId = "${YourIotInstanceId}"; 
              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
                  + ",iotInstanceId=" + iotInstanceId
                  + ",consumerGroupId=" + consumerGroupId
                  + "|";
              //计算签名,password组装方法,请参见AMQP客户端接入说明文档。
              String signContent = "authId=" + accessKey + "&timestamp=" + timeStamp;
              String password = doSign(signContent,accessSecret, signMethod);
              //接入域名,请参见AMQP客户端接入说明文档。
              String connectionUrl = "failover:(amqps://${YourHost}: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");
              // 创建连接。
              Connection connection = cf.createConnection(userName, password);
              ((JmsConnection) connection).addConnectionListener(myJmsConnectionListener);
              // 创建会话。
              // Session.CLIENT_ACKNOWLEDGE: 收到消息后,需要手动调用message.acknowledge()。
              // Session.AUTO_ACKNOWLEDGE: SDK自动ACK(推荐)。
              Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
              connection.start();
              // 创建Receiver连接。
              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");
                  logger.info("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);
          }
      }

      您需要按照如下表格中的参数说明,修改上述代码中的参数值。

      参数 示例 说明
      accessKey LTAI4GFGQvKuqHJhFa******

      登录物联网平台控制台,将鼠标移至账号头像上,然后单击AccessKey管理,获取AccessKey ID和AccessKey Secret。

      说明 如果使用RAM用户,您需授予该用户管理物联网平台的权限(AliyunIOTFullAccess),否则将连接失败。授权方法请参见授权RAM用户访问物联网平台
      accessSecret iMS8ZhCDdfJbCMeA005sieKe******
      consumerGroupId VWhGZ2QnP7kxWpeSSjt****** 步骤3中创建的路灯消费组ID。请在物联网平台控制台公共实例页面,选择规则引擎 > 服务端订阅,单击消费组列表页签,找到路灯消费组获取消费组ID。
      iotInstanceId "" 实例ID。本文使用公共实例,因此值为空,即iotInstanceId = ""
      clientId 12345 表示客户端ID,建议使用您的AMQP客户端所在服务器UUID、MAC地址、IP等唯一标识。长度不可超过64个字符。

      登录物联网平台控制台,在对应实例的规则引擎 > 服务端订阅 > 消费组列表,单击消费组对应的查看消费组详情页将显示该参数,方便您识别区分不同的客户端。

      connectionUrl 198426864******.iot-amqp.cn-shanghai.aliyuncs.com AMQP客户端接入物联网平台的域名。本文使用公共实例,因此接入域名的格式为${uid}.iot-amqp.${regionId}.aliyuncs.com

      其中,${uid}表示您的阿里云账号ID,可在控制台上单击头像,获取账号ID;${regionId}表示您公共实例所在的地域,本文中地域为华东2(cn-shanghai),因此完整的connectionUrl值如下所示:

      connectionUrl = "failover:(amqps://198426864*******.iot-amqp.cn-shanghai.aliyuncs.com:5671?amqp.idleTimeout=80000)"
      + "?failover.reconnectDelay=30"
    3. 运行示例代码后,返回类似如下日志信息,表示AMQP客户端已接入物联网平台并成功接收消息。
      [pool-1-thread-4] INFO AmqpJavaClientDemo - receive message, topic = /a10FL******/device1/thing/event/property/post, messageId = 1343530036824******, content = {"deviceType":"CustomCategory","iotId":"nTT9nDODtdWDfVp5******","requestId":"795","checkFailedData":{},"productKey":"a10FL******","gmtCreate":1609157497013,"deviceName":"device1","items":{"LightCurrent":{"value":1.5,"time":1609157497016}}}
更多服务端订阅设备消息相关内容,请参见: