从 TCP 套接字接收文本

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

用法说明

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

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

参数

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

参数	描述
名称	用于在 GeoEvent Manager 中引用的输入连接器的描述性名称。
默认空间参考	当从坐标不是假定的 WGS84 地理坐标系的纬度和经度值的属性字段值构造几何时使用的空间参考的熟知 ID (WKID)，或接收的不包含空间参考的几何字符串。 还可以指定熟知文本 (WKT) 值或包含 WKID 或 WKT 的属性字段的名称。
服务器端口	建立 TCP 套接字时使用的服务器端口。 TCP 客户端必须能够发现并连接到此端口。 默认端口为 5565，但可以使用任何可用的服务器端口。
消息分隔符	单个文字字符，表示事件数据记录的结束。 Unicode 值可用于指定字符分隔符。 该字符不应用引号括起。 换行符 (\n) 是常见的记录结束分隔符。
属性分隔符	用于将消息中的一个属性值与另一个属性值分开的单个文字字符。 Unicode 值可用于指定字符分隔符。 该字符不应用引号括起。 逗号是常见的属性分隔符。
预期日期格式	该模式用于匹配日期/时间值的预期字符串表示形式，并将它们转换为 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 了解如何调整日期/时间值。
传入数据包含 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 点几何。 此参数在从字段构建几何设置为是时显示，设置为否时隐藏。
数字格式化语言	从数据值格式化数字时用于区分区域设置敏感行为的区域设置标识符 (ID)。 默认值为安装 GeoEvent Server 的计算机的区域设置。 有关详细信息，请参阅 Java 支持的区域设置。