Skip To Content

Получать текст из TCP-сокета

Входной Оператор подключения Получать текст из TCP-сокета можно использовать для получения данных о событиях в формате текста с разделителями, который был получен через подключение к TCP-сокету. Чаще всего разделителем между значениями является запятая, поэтому этот тип данных иногда называют значениями с разделителями-запятыми. ArcGIS GeoEvent Server может использовать любой нормальный ASCII-символ в качестве разделителя для отделения атрибутивных значений данных.

Текст с разделителями, отправленный через GeoEvent Simulator

Примечания по использованию

  • Используйте этот оператор подключения для получения текста с разделителями из любого клиента TCP, который может видеть ваш сервер и подключаться к указанному TCP-сокету.
  • Этот входной оператор подключения соединяет в пару Входящий адаптер Текст с Входящим транспортом TCP.
  • Обычно этот оператор используется для получения симулированных записей о данных событий из GeoEvent Simulator.
  • По умолчанию оператор открывает TCP-сокет на порте 5565, но может использоваться любой доступный порт сервера.
  • Можно настроить несколько потоков получения текста из входных операторов TCP-сокета, но для каждого понадобится отдельный порт.
  • Несколько клиентских приложений TCP могут одновременно подключаться и отправлять данные на один входной оператор.
  • Необходим Разделитель сообщений Этот единичный символ определяет конец записи о событии. Новая линия (\n) - это наиболее типичный разделитель конца записи.
  • Необходим Разделитель атрибутов Этот единичный символ отделяет одно атрибутивное значение от другого. Обычно таким разделителем является запятая (,).
  • GeoEvent Simulator интерпретирует конец файла как неявный разделитель событий, когда файл симуляции загружается в память. Нет необходимости заканчивать файл симуляции пустой строкой, чтобы принудительно включить разделитель сообщений. Другие TCP-клиенты могут действовать по-другому.
  • Первый атрибут полученной строки данных с разделителями может использоваться для указания имени Определения GeoEvent. Это полезно, когда ожидается получение дейтаграмм с различными типами данных атрибутов или количеством атрибутов данных; сами данные могут помочь понять, какое Определение GeoEvent следует использовать адаптеру для интерпретации полученных значений данных. Для включения этой функциональности используйте Определение GeoEvent Входящие данные содержат. Как правило, все записи данных, полученные на данном сокете, будут иметь одну и ту же схему, поэтому для этого свойства должно быть установлено значение Нет (по умолчанию).

Параметры

ПараметрОписание

Имя

Описательное имя входного коннектора, используемое для справки в GeoEvent Manager.

Пространственная привязка по умолчанию

Известный идентификатор (WKID) пространственной привязки, используемый при построении геометрии из значений полей атрибутов, координаты которых не являются значениями широты и долготы для предполагаемой географической системы координат WGS84, или строки геометрии, не включающие пространственную привязку. Также может быть указано известное текстовое значение (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 (epoch long integer; UTC)
  • "Tue Dec 31 23:59:59 -0000 2019" – общий строковый формат веб-сервисов
  • "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 задано значение Нет, и скрыто, если выбрано значение Да

Построить геометрию из полей

Указывает, должен ли входной коннектор создавать геометрию точки, используя значения координат, полученные в качестве атрибутов. По умолчанию – Нет.

  • Да – значения из указанных полей атрибутов событий будут использоваться для построения геометрии точек.
  • Нет – точечная геометрия не будет строится. Предполагается, что поле атрибута содержит значение, которое может быть интерпретировано как геометрия или запись события является непространственной (не имеет геометрии).

Поле геометрии X

(Условия)

Поле атрибута в данных входящего события, содержащее координатную часть X (например, горизонталь или долготу) местоположения точки.

Это свойство показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если выбрано значение Нет

Поле геометрии Y

(Условия)

Поле атрибута в данных входящего события, содержащее координатную часть Y (например, вертикаль или широту) местоположения точки.

Это свойство показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если выбрано значение Нет

Поле геометрии Z

(Условия)

Имя поля в данных входящего события, содержащего координатную часть Z (например, глубина или высота) местоположения точки. Если оставить пустым, значение Z будет опущено и будет построена 2D геометрия точки.

Это свойство показывается, когда для Построить геометрию из полей задано значение Да, и скрыто, если выбрано значение Нет

Язык форматирования чисел

Идентификатор локали (ID), используемый для чувствительного к локали поведения при форматировании чисел из значений данных. По умолчанию используется локаль компьютера, на котором установлен GeoEvent Server. Дополнительные сведения см. в разделе Поддерживаемые локали Java.