Парсер: регулярные выражения, OQuery, JSON

«Парсер» разбирает любые текстовые структуры: HTML, XML, JSON или произвольный текст. Чаще всего его применяют для разбора ответов веб-сервисов, полученных компонентом «Запрос к WEB-сервису».

На вход подаётся документ — структура, подлежащая разбору. Задать её можно текстом, переменной, выражением или функцией. Дальше выбирается алгоритм разбора и пишется поисковый запрос; результат сохраняется в переменную.

Свойства компонента

Функции по алгоритмам

Язык OQuery

Запрос OQuery — это набор команд, записанный в одну строку и выполняемый слева направо. Для отладки запросов служит программа OQuery-tester.exe.

Уровни

Простые команды

Порядок перечисления команд на результат не влияет: TABLE#big.sample и TABLE.sample#big — одно и то же.

Операции сравнения значений атрибута

Суффиксы и функции позиции

Синонимы eq: equal, range.

Сложные функции

A:has(:not(IMG))   — все теги A, которые содержат не IMG
A:not(:has(IMG))   — все теги A, которые не содержат IMG

Операции и скобки

Типовые наборы команд

Разбор XML: пример

Пусть разбирается такая структура — два листа, на первом матрица 3×3, на втором 2×2:

<info>
  <list index="1" name="matrix33">
    <row id="1" name="aaa">
      <col id="1" name="r1c1" />
      <col id="2" name="r1c2" />
      <col id="3" name="r1c3" />
    </row>
    …
  </list>
  <list index="2" name="matrix22">
    <row id="1" name="ddd">
      <col id="1" name="element11" />
      <col id="2" name="element12" />
    </row>
    <row id="2" name="eee">
      <col id="1" name="element21" />
      <col id="2" name="element22" />
    </row>
  </list>
</info>

Добравшись до нужного тега, значение его атрибута берут функцией «Значение атрибута», указав имя атрибута в поле «Атрибут». Если запрос вернул несколько тегов, их перебирают в цикле через «Номер элемента», а общее число узнают функцией «Количество элементов».

Регулярные выражения

Применяются для разбора обычного текста. Язык совпадает со стандартом .NET.

Примеры

Если выражение вернуло несколько значений, их перебирают в цикле; общее число даёт функция «Количество найденных».

Парсер JSON

У платформы собственный синтаксис разбора JSON, и он предельно прост:

• доступ к значению — по имени в кавычках;
• переход к вложенному объекту — через /;
• обращение к элементу массива — по индексу, отсчёт с нуля.

Для документа вида:

{
  "info": {
    "list1": {
      "index": 1,
      "name": "matrix",
      "rows": [
        { "id": 1, "name": "row1",
          "cols": [ {"id":"1","name":"element11"}, {"id":"2","name":"element12"} ] },
        { "id": 2, "name": "row2",
          "cols": [ {"id":"1","name":"element21"}, {"id":"2","name":"element22"} ] }
      ]
    }
  }
}

Функция «Содержимое» вернёт значение в кавычках, «Восстановленное содержимое» — без них. Для дальнейших сравнений в сценарии обычно нужен второй вариант.

Как ускорить разбор