从 UDP 套接字接收文本

“从 UDP 套接字接收文本”输入连接器可用于改编通过 UDP 套接字连接接收的格式化为分隔文本的事件数据。 属性值之间的分隔符通常是逗号 (,)，因此这种类型的数据有时被称为逗号分隔值。 ArcGIS GeoEvent Server 可以使用任何 ASCII 可打印字符作为分隔符来分隔数据属性值。

用法说明

使用“从 UDP 套接字接收文本”输入连接器时，应记住以下事项：

• 此输入连接器将文本入站适配器与 UDP 入站传输进行配对。
• 使用此输入连接器从任何能够查看您的服务器计算机以及连接到指定 UDP 套接字端口的 UDP 客户端接收分隔文本。
• 默认情况下，该连接器在端口 5000 上打开 UDP 套接字，但是可以使用任何可用的服务器端口。
• 可以配置多个“从 UDP 套接字接收文本”输入，但每个都必须指定唯一端口。
• 多个 UDP 客户端应用程序可以同时连接并发送数据到已配置的单个输入。
• 消息分隔符参数为必填项。 此单个字符用于指定事件记录的结尾。 换行符 (\n) 是常见的记录结束分隔符。
• 属性分隔符参数为必填项。 该单个字符用于将一个属性值与另一个属性值分隔开。 逗号 (,) 是常见的属性分隔符。
• UDP 数据报包通常会压缩消息，而客户端应用程序可能不包含消息间的消息分隔符。 要追加到各个消息内的字符参数支持将隐式消息分隔符追加到接收的每个消息中。
• 当向消息追加源 IP 参数设置为是时，客户端应用程序的 IP 地址和端口将被追加到数据报包（消息）中。 如果源 IP 前缀字符参数中指定的字符与属性分隔符参数中指定的字符相同，连接器会将追加的 IP 和端口解释为字符串属性值。 确保 GeoEvent 定义包含一个属性字段，以容纳追加到每个数据报的数据。
• 接收的分隔数据字符串的第一个属性可用于指定 GeoEvent 定义的名称。 当期望接收具有不同属性数据类型或多种数据属性的数据报包时，这点十分有用；数据本身可以帮助指定连接器应用来解释所接收数据值的 GeoEvent 定义。 使用传入数据包含 GeoEvent 定义参数以利用此功能。 但是，在给定套接字上接收的所有数据记录通常都将具有相同的方案，因此应将此参数设置为否（默认值）。

参数

以下是“从 UDP 套接字接收文本”输入连接器的参数：

参数	描述
名称	用于在 GeoEvent Manager 中引用的输入连接器的描述性名称。
默认空间参考	当从坐标不是假定的 WGS84 地理坐标系的纬度和经度值的属性字段值构造几何时使用的空间参考的熟知 ID (WKID)，或接收的不包含空间参考的几何字符串。 还可以指定熟知文本 (WKT) 值或包含 WKID 或 WKT 的属性字段的名称。
服务器端口	建立 UDP 套接字时使用的服务器端口。 UDP 客户端必须能够发现并连接到此端口。 默认端口为 5000，但可以使用任何可用的服务器端口。
向消息追加源 IP	指定传输是否应将发送 UDP 数据报的计算机的 IP 地址追加到数据报（消息）。 如果指定的源 IP 前缀字符参数与属性分隔符的字符相同，则适配器会将追加的 IP 和端口值解释为附加的字符串属性值。 确保 GeoEvent 定义包含一个属性字段，以容纳追加到每个数据报的数据。 是 - 客户端用于发送其消息的 IP 地址和端口将追加到每个收到的事件记录中。 否 - 客户端 IP 地址和端口值不会追加到每个收到的事件记录中。
源 IP 前缀字符 （条件分析）	传输将用于分隔将其追加到每个 UDP 数据报的 IP 地址和端口号的单个文字字符。 通常，使用与消息主属性值的属性分隔符相同的字符，以便 IP 地址和端口作为新属性追加；但 IP 地址和端口值可以使用不同的分隔符连接到最终字符串值。 此参数在向消息追加源 IP 设置为是时显示，向消息定义追加源 IP设置为否时隐藏。
要追加到各个消息内的字符	在将消息的原始字节数组发送到适配器之前，传输将追加到每个 UDP 数据报的单个文字字符。 UDP 数据报通常是紧凑的消息；客户端应用程序可能不包含消息之间的分隔符。 但是，适配器需要一个消息分隔符指示事件数据记录的结束，因此如果广播 UDP 客户端不包含消息分隔符，请使用此参数定义一个分隔符。
缓冲区大小(字节)	指定传输将分配的缓冲区大小，以保存从广播 UDP 客户端应用程序接收的原始字节。 默认值为 2048 字节。 缓冲区必须足够大，以容纳IP标头、UDP 标头、属性数据值、作为数据接收的几何的字符串表示，以及追加到每个接收消息的任何数据。
消息分隔符	单个文字字符，表示事件数据记录的结束。 Unicode 值可用于指定字符分隔符。 该字符不应用引号括起。 换行符 (\n) 是常见的记录结束分隔符。
属性分隔符	用于将消息中的一个属性值与另一个属性值分开的单个文字字符。 Unicode 值可用于指定字符分隔符。 该字符不应用引号括起。 逗号是常见的属性分隔符。
传入数据包含 GeoEvent 定义	指定是否应将每个分隔行文本的第一个属性值用作 GeoEvent 定义的名称。 有关详细信息，请参阅上面的使用说明。 是 - 每个事件记录中的第一个属性字段是 GeoEvent 定义（现有或新的）的名称。 否 - 所有事件记录共享一个公共方案，因此共享一个 GeoEvent 定义。 每个事件记录中的第一个属性字段是传感器数据，而不是 GeoEvent 定义的名称。
创建无法识别的事件定义 （条件分析）	指定当具有指定名称的 GeoEvent 定义不存在时是否应创建新的 GeoEvent 定义。 当分隔文本文件包含来自不同类型传感器的事件记录时，第一个属性值用于指定事件类型，此属性值用作 GeoEvent 定义名称。 是 - 如果尚不存在具有指定名称的事件定义，则将创建新的 GeoEvent 定义。 否 - 不会创建新的 GeoEvent 定义。 没有相应 GeoEvent 定义的入站事件数据无法调整，也不会被处理。 此参数在传入数据包含 GeoEvent 定义设置为是时显示，设置为否时隐藏。
创建 GeoEvent 定义 （条件分析）	指定是否应将新的或现有的 GeoEvent 定义用于入站事件数据。 GeoEvent Server 需要 GeoEvent 定义，以了解入站事件数据属性字段和数据类型。 是 - 将根据收到的第一个事件记录的模式创建新的 GeoEvent 定义。 否 - 不会创建新的 GeoEvent 定义。 选择与入站事件数据的方案匹配的现有 GeoEvent 定义。 此参数在传入数据包含 GeoEvent 定义设置为否时显示，设置为是时隐藏。
GeoEvent 定义名称(新) （条件分析）	分配给新 GeoEvent 定义的名称。 如果已存在具有指定名称的 GeoEvent 定义，则会使用现有的 GeoEvent 定义。 收到的第一个数据记录将用于确定后续数据记录的预期方案，将根据第一个数据记录的方案创建新的 GeoEvent 定义。 此参数在创建 GeoEvent 定义设置为是时显示，设置为否时隐藏。
GeoEvent 定义名称(现有) （条件分析）	在调整接收数据以创建事件数据以供 GeoEvent 服务处理时使用的现有 GeoEvent 定义的名称。 此参数在创建 GeoEvent 定义设置为否时显示，设置为是时隐藏。
从字段构建几何	指定输入连接器是否应使用作为属性接收的坐标值构造点几何。 默认为否。 是 - 来自指定事件属性字段的值将用于构造点几何。 否 - 不会构造点几何。 假定属性字段包含可以解释为几何的值，或者事件记录为非空间记录（不具有几何）。
X 几何字段 （条件分析）	入站事件数据中包含点位置 x 坐标部分（例如水平或经度）的属性字段。 此参数在从字段构建几何设置为是时显示，设置为否时隐藏。
Y 几何字段 （条件分析）	入站事件数据中包含点位置 y 坐标部分（例如垂直或纬度）的属性字段。 此参数在从字段构建几何设置为是时显示，设置为否时隐藏。
Z 几何字段 （条件分析）	入站事件数据中包含点位置 z 坐标部分（例如深度或高度）的字段的名称。 如果留空，则将省略 z 值，并将构建 2D 点几何。 此参数在从字段构建几何设置为是时显示，设置为否时隐藏。
预期日期格式	该模式用于匹配日期/时间值的预期字符串表示形式，并将它们转换为 Java 日期值。 模式的格式遵循 Java SimpleDateFormat 类约定。 而 GeoEvent Server 更偏好以 ISO 8601 标准表示的日期/时间值，通常被识别为日期值的日期/时间值的多个字符串表示可以转换为 Java 日期值，且无需指定预期日期格式模式。 其中包括： “2019-12-31T23:59:59”- ISO 8601 标准格式 1577836799000 - Java 日期（时间长整型；UTC） “Tue Dec 31 23:59:59 -0000 2019”- 常见的 web 服务字符串格式 “12/31/2019 11:59:59 PM”- 美国使用的通用格式（12 小时制） “12/31/2019 23:59:59”- 美国使用的通用格式（24 小时制） 如果收到的日期/时间值使用并非上述五种之一的约定表示，则必须指定一个预期日期格式模式以便 GeoEvent Server 了解如何调整日期/时间值。
数字格式化语言	从数据值格式化数字时用于区分区域设置敏感行为的区域设置标识符 (ID)。 默认值为安装 GeoEvent Server 的计算机的区域设置。 有关详细信息，请参阅 Java 支持的区域设置。
组播模式	指定输入连接器是否应加入组播组，以便接收由内部网络路由到一组预期接收器的消息。 默认为否。 是 - 输入连接器将接收路由到指定组地址的多播数据包。 否 - 输入连接器将作为单播（例如点对点）接收器运行。 消息应该广播到指定的服务器端口，该端口用于在运行 GeoEvent Server 的服务器计算机上建立 UDP 套接字。
组播组 （条件分析）	提供组播模式下输入连接器将加入的组地址。 输入连接器将接收发送到该组地址的数据包。 IP 地址范围 239.x.x.x 由 RFC 2365 保留，用于单个局域网内的组织特定管理用途。 此参数在组播模式设置为是时显示，设置为否时隐藏。