WEBSOCKET RIVER

WebSocket River
WebSocket River提供启用Predix机器的设备与Predix云中的Predix时间序列服务之间的互联性。

注：
参见时间序列服务。
下图显示了WebSocketRiver与Predix时间序列服务之间的用例。 图1WebSocketRiver用例

WebSocket River到时间序列服务的数据传输
WebSocket River在您首次尝试进行数据传输时建立一个连接，并尽可能保持该通道打开。每次数据传输都会确WebSocket连接是打开的。如果连接已经关闭，服务会打开一个新连接。 send 操作是线程安全的，因为任意给定时间只存在一个有效的WebSocket连接。
从WebSocket客户端到WebSocket服务器的请求是异步的。如果要确保Predix时间序列服务（在本例中用作WebSocket服务器）接收到所有请求，需要一个管理线程保存所有请求的超时进度表。
数据格式
时间序列服务接受符合推送时间序列数据中所示特定格式的数据。如果要符合时间序列格式要求，请留意以下示例中显示的时间序列格式：

WebSocket River的 send() 方法接受这种格式的数据，或者序列化 PDataValue 对象格式的数据。将 PDataValue 对象序列化为所需格式的示例如下所示：
如果您正在使用带有Spillway的WebSocket River和提供的机器适配器（例如 OPC-UA、Modbus或HealthMonitor），此转换将会自动发生。在本例中您无需进行任何转换。
限制
使用WebSocket River时需要注意以下限制：
• 您只能将数据发送至Predix时间序列服务。
• 您只能以数据格式部分规定的格式将数据传递至WebSocket River。
• 请求被确认的顺序无法保证，因为通信为异步。
支持的数值数据类型

注：
布尔值将被转换为数值数据类型。 True 被转换为 1 ，而 False 被转换为 0。
依赖项
消费此服务需要Maven依赖项和OSGi导入包：
• pom.xml文件中需要以下Maven依赖项：

• 消费捆绑束需要以下OSGi导入：

获取WebSocket River发送服务
在您的服务中为WebSocket River发送服务添加一个引用。
使用声明式服务注入WebSocket River发送服务。
以下示例显示了如何注入服务。

使用WebSocket River发送API
WebSocket River发送API用于在本机上实现发送服务。
回顾WebSocket River发送API了解如何实现WebSocket River。
1. 导航至/docs/apidocs.zip并提取以下文件中的所有文件
2. 找到并打开Javadoc API，/docs/apidocs/index.html/com.ge.dspmicro.websocketriver.send.api。
配置WebSocket River发送服务
WebSocket River发送服务将配置有WebSocket River的机器链接至时间序列云。
Predix机器中的WebSocket River服务配置必须与云中运行的时间序列服务的配置兼容。
• Predix机器云身份管理服务配置中的UAA令牌URL必须是云中的时间序列服务实例的可信发布者。
• Predix Zone ID的标头名称和数值必须与云中的时间序列服务实例的配置相匹配。这些数值可以通过运行绑定至时间序列服务的应用程序的一个cf env命令进行检索。示例值如下所示。

• 分配至Predix机器实例的客户端必须拥有前面示例中zone-token-scope列出的权限。在本示例中，这些权限为
timeseries.zones.9378e3db-e683-46a2-97c2-ccd11d75869d.user ， timeseries.zones.9378e3db-e683-46a2-97c2-ccd11d75869d.ingest
您可以配置您的WebSocket River的实现。
格式化.config文件（不是.cfg文件）内的属性值时，使用类型字符，后跟引用的值字符串表示。例如，一个布尔型属性=B”true”。小写类型字符表示基本数据。字符串的类型可以省略。下表列出了类型和对应的类型字符：

数组格式为属性=<类型>[”<值1>”,”<值2>”]。例如，整型数组属性=I[“1”, “2”, “3”].清晰起见，可使用反斜杠分隔。
1. 找到并打开以下文件：/configuration/machine /com.ge.dspmicro.websocketriver.send-[n].config。
2. 设置以下属性的值：