Skip To Content

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

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

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

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

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

Параметры

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

Имя

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

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

Известный идентификатор (WKID) пространственной привязки, используемый при построении геометрии из значений полей атрибутов, координаты которых не являются значениями широты и долготы для предполагаемой географической системы координат WGS84, или строки геометрии, не включающие пространственную привязку. Также может быть указано известное текстовое значение (WKT) или имя поля атрибута, содержащего WKID или WKT.

Порт сервера

Порт сервера, используемый при установке сокета UDP. Клиенты UDP должны иметь возможность обнаруживать и подключаться к этому порту. По умолчанию используется порт 5000, но можно использовать любой доступный порт сервера.

Прикрепить исходный IP к сообщению

Указывает, должен ли транспорт добавлять IP-адрес компьютера, отправившего дейтаграмму UDP к дейтаграмме (сообщению). Если указанное свойство Символ префикса IP источника совпадает с Разделителем атрибутов, адаптер будет интерпретировать добавленные значение IP и порт как дополнительное строковое значение атрибута. Убедитесь, что Определение GeoEvent включает атрибутивное поле для добавления данных, присоединенных к каждой дейтаграмме.

  • Да – IP-адрес и порт, используемые клиентом для отправки сообщений, будут добавлены к каждой полученной записи события.
  • No – Значения IP-адреса и порта клиента не будут добавляться к каждой полученной записи события.

Символ-префикс исходного IP

(Условия)

Один буквенный символ, используемый транспортом для разделения IP-адреса и номера порта, добавляемых к каждой датаграмме UDP. Обычно используется тот же символ, что и Разделитель атрибутов для значений основного атрибута сообщения, поэтому 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 задано значение Нет, и скрыто, если выбрано значение Да

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

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

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

Поле геометрии 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 (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 знал, как следует адаптировать значения даты/времени.

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

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

Режим мультикаст

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

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

Группа мультикаст

(Условия)

Введите адрес группы, к которой присоединится входной коннектор в режиме мультикаст. Входной коннектор будет получать пакеты, отправленные на этот адрес группы. Диапазон IP-адресов 239.x.x.x зарезервирован RFC 2365 для специального использования администратором организации в пределах одной локальной сети.

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