订阅数据

概述

应用服务器通过调用物联网平台的“订阅平台业务数据”接口，告知物联网平台消息推送的地址和通知类型，比如设备业务数据、设备告警等，接口信息详见API参考文档。

在订阅场景下，物联网平台是客户端，应用服务器是服务端，物联网平台调用应用服务器的接口，并向应用服务器推送消息。此时，如果订阅的回调地址为HTTPS地址，则需要在物联网上传CA证书。CA证书由应用服务器侧提供（证书获取方法可参考导出CA证书），并在开发中心的“应用 > 对接信息 > 应用安全 > 推送证书”上传，详见上传CA证书。

本文档基于调用API接口的代码样例（Java）进行指导，帮助开发者理解“订阅平台业务数据”接口的调用。

操作指导

在eclipse中，选择“src > com.huawei.utils > Constant.java”，修改“CALLBACK_BASE_URL”，填写回调的IP地址和端口号。
同一个应用下，所有订阅类型的回调地址的IP和端口必须一致。回调地址的合法性和连通性可以通过开发中心的“订阅调试”功能进行检测。
在eclipse中，选择“src > com.huawei.service.subscribtionManagement”，右键单击“SubscribeServiceNotification.java”，选择“Run As > Java Application”。
在控制台查看响应消息的打印日志，如果所有类型的订阅均获得“201 Created”响应，则说明订阅成功。
说明：
- 如需修改订阅的回调地址，在“Constants.java”类中修改“CALLBACK_BASE_URL”的值，再次运行
  “SubscribeServiceNotification.java”即可，新的回调地址会覆盖原来的回调地址。
- 订阅完成后，开发者可参考“src > com.huawei.testMessagePush > SimpleHttpServer.java”搭建一个应用服务器来接收平台推送的Post消息（仅供参考）。如果需要在本地测试平台回调功能和查看回调内容，可以使用“北向JAVA API Demo”提供的类“src > com.huawei.testMessagePush > TestSubscribeAllServiceNotification.java”，并参考数据上报中的操作。