1C:JSON парсер и сериализатор

JSON парсер и сериализатор c полной поддержкой стандарта, широким набором сериализуемых типов и продвинутым синтаксический анализатором для платформы 1С:Предприятие 8.

Особенности

Парсер и сериализатор поддерживают два режима (формата) работы:

Стандартный – полная поддержка стандарта JSON;
Альтернативный – направлен на применение в проектах подразумевающих постоянный двусторонний обмен данными и требующих повышенную скорость парсинга, минимизацию пересылаемых пакетов и однозначную идентификацию ссылочных типов во входящих данных.

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

При необходимости, сериализатор может маскировать кириллические символы современных алфавитов славянских языков “АБВГҐДЂЃЕЀЁЄЖЗЅИЍІЇЙЈКЛЉМНЊОПРСТЋЌУЎФХЦЧЏШЩЪЫЬЭЮЯ”.

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

Альтернативный режим

Не поддерживается форматирование, как во входящих, так и в исходящих данных;
Сериализация ссылочных типов в строковое служебное представление.

Приятности

Парсер

Устойчивость к некорректным данным и не подверженность injection атакам;
Продвинутый синтаксический анализатор (указывает место и тип ошибки в данных);
Поддержка форматирования во входящих данных (только стандартный режим);
Безопасный разбор форматирования - незамаскированные символы форматирования в строковых значениях не будут утеряны;
Поддержка строк в одинарных и в двойных кавычках;
Автоматическое приведение объекта к структуре или соответствию в зависимости от имен свойств;
Автоматическое преобразование к типу Дата строки вида “9999-99-99T99:99:99Z”;
Автоматическое преобразование к типу УникальныйИдентификатор строки вида “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”;
Автоматического определение режима (стандартного или альтернативного) входящих данных;
Автоматического определение необходимости отсечения представления ссылок;
Однозначная идентификация ссылок (только альтернативный режим).

Сериализатор

Поддержка форматирования исходящих данных (только стандартный режим);
Широкий состав сериализуемых типов данных, в том числе ссылок;
Автоматическое приведение значений ключей соответствий к строковому представлению 1C;
Автоматическое преобразование неподдерживаемых типов к строке;
Нечувствительность к локализации.

Неприятности

Нестандартно форматированный код на гране читаемости;
Сериализатор ориентирован на средние-крупные пакеты данных.

Сериализуемые типы

Неопределено;
Null;
Примитивные типы (все);
Универсальные коллекции значений (все);
УникальныйИдентификатор;
ЛюбаяСсылка;
Запрос;
РезультатЗапроса;
ВыборкаИзРезультатаЗапроса;
ПостроительЗапроса;
ПостроительОтчета;
ДанныеФормыКоллекция (только 8.2);
ДанныеФормыСтруктураСКоллекцией (только 8.2);
ДанныеФормыДерево (только 8.2);
ДвоичныеДанные;
Картинка;
ХранилищеЗначения.

Порядок сериализации типов

Неопределено – сериализуется как Null;
Null – согласно стандарту;
Примитивные типы – согласно стандарту;
Массивы – массив, согласно стандарту: [ Значение, ... ]
Структуры и соответствия – объект, согласно стандарту; { Ключ:Значение, ... }
СписокЗначений – массив объектов с тремя свойствами “Значение”, “Представление” и “Пометка”; [ { "Значение":Значение, "Представление":Представление, "Пометка":Пометка }, ... ]
КлючИЗначение – объект с двумя свойствами “Ключ” и “Значение”; { "Ключ":Ключ, "Значение":Значение }
ТаблицаЗначений – массив объектов: [ { Колонка:Значение, ... }, ... ]
ДеревоЗначений – массив объектов с обязательным свойством “Строки”: [ { Колонка:Значение, ... , "Строки":[ { Колонка:Значение, ... , "Строки":[ ... ] } , ... ] }, ... ]
УникальныйИдентификатор – приведение к строке вида “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”;
ЛюбаяСсылка:
- – Стандартный режим – получение уникального идентификатора ссылки и его сериализация;
- – Альтернативный режим – приведение к строке служебного вида “¦ref¦ ... ¦”.
При сериализации ссылок в режиме автоматически передачи не только сериализованного значения ссылки, но и ее представления. Каждая ссылка передается как объект с двумя свойствами “Ссылка” и “Представление”. { "Ссылка":Ссылка, "Представление":Представление }
Запрос – автоматически выполняется и сериализуется как таблица значений;
РезультатЗапроса – сериализуется как таблица значений;
ВыборкаИзРезультатаЗапроса – сериализуется как структура значений текущей запись результата запроса;
ПостроительЗапроса – автоматически выполняется и сериализуется как таблица значений;
ПостроительОтчета – автоматически выполняется и сериализуется как таблица значений;
ДанныеФормыКоллекция – сериализуется как таблица значений;
ДанныеФормыСтруктураСКоллекцией – сериализуется как таблица значений;
ДанныеФормыДерево – сериализуется как дерево значений;
ДвоичныеДанные – кодируется по алгоритму base64 и сериализуется как строка;
Картинка – автоматически преобразуется и сериализуется как двоичные данные;
ХранилищеЗначения – автоматически извлекается сохраненное значение и сериализуется в зависимости от типа извлеченного значения.

Производительность

Производительность парсера исключительно зависит от набора входящих данных, а также от наличия форматирования. Наихудшим вариантом является форматированный массив чисел, наилучшим – неформатированный массив строк.
Intel Core 2 Duo T5870 @ 2GHz – форматированный массив со всеми приблизительно равномерно встречающимися типами данных:

Парсер: 35 Кбайт/с.
Сериализатор: 165 Кбайт/с.

История изменений

Версия 2.0.0.18:

– (Изменение) При сериализации строк специальный символ бекслеш ( \ ) более не маскируется;
– (Оптимизация) Устранена существенная деградация производительности при парсинге JSON большого размера;
– (Исправление) Исправлены опечатки.

Версия 2.0.0.17:

– (Новое) Маскирование кириллических символов современных алфавитов славянских языков (по требованию);
– (Новое) Поддержка сериализатором типов: ДвоичныеДанные, Картинка, ХранилищеЗначения;
– (Изменение) Рефакторинг переменных и процедур;
– (Исправление) Сериализация типа COMSafeArray;
– (Исправление) Удалены лишние ключевые слова "Экспорт".
– (Оптимизация) Уменьшение проверок связанных с режимом и параметрами парсинга и сериализцаии;
– (Оптимизация) Проверка необходимости анализа форматирования вынесена из процедуры анализа форматирования;
– (Оптимизация) Изменен алгоритм автоматического приведение объекта к структуре или соответствию в зависимости от имен свойств;
– (Оптимизация) Отказ от явного приведения типов в пользу неявного в операторах условий;
– (Оптимизация) Отказ от оператора "Попытка Исключение" при преобразовании строки к уникальному идентификатору;
– (Оптимизация) Изменен порядок проверки типов при парсинге.

Версия 2.0.0.15:

– Релиз.

Alexandr Pereverzev Blog