Парсер JSON

(0)


Глобальный контекст (Global context)

ПрочитатьJSON (ReadJSON)

Синтаксис:

ПрочитатьJSON(<ЧтениеJSON>, <ПрочитатьВСоответствие>, <ИменаСвойствСоЗначениямиДата>, <ОжидаемыйФорматДаты>, <ИмяФункцииВосстановления>, <МодульФункцииВосстановления>, <ДополнительныеПараметрыФункцииВосстановления>, <ИменаСвойствДляОбработкиВосстановления>, <МаксимальнаяВложенность>)

Параметры:

<ЧтениеJSON> (обязательный)

Тип: ЧтениеJSON. 

Объект чтения JSON.

<ПрочитатьВСоответствие> (необязательный)

Тип: Булево. 

Если установлено Истина, чтение объекта JSON будет выполнено в Соответствие.

Если установлено Ложь, объекты будут считываться в объект типа Структура.

Примечание. При десериализации объектов JSON в структуру необходимо помнить о требованиях к ключам структуры. Если при десериализации объекта будет найдено имя свойства, недопустимое для ключа структуры, то будет вызвано исключение.

Значение по умолчанию: Ложь.

<ИменаСвойствСоЗначениямиДата> (необязательный)

Тип: Массив, Строка, ФиксированныйМассив. 

Массив, элементы которого содержат имена свойств JSON, для которых нужно вызывать восстановление даты из строки.

Если имя свойства указано в этом параметре и указано в параметре ИменаСвойствДляОбработкиВосстановления, то для таких свойств восстановление осуществляется в функции восстановления.

Если восстановление даты из значения свойства невозможно, то будет сгенерировано исключение.

Значение по умолчанию: Неопределено.

<ОжидаемыйФорматДаты> (необязательный)

Тип: ФорматДатыJSON. 

Ожидаемый формат даты при десериализации объекта в формате JSON.

Если в результате десериализации значение не является строкой и имеет формат даты, отличный от ожидаемого, то будет вызвано исключение.

Значение по умолчанию: ISO.

<ИмяФункцииВосстановления> (необязательный)

Тип: Строка. 

Данная функция вызывается при чтении каждого свойства и должна иметь следующие параметры:

<Свойство> - значение типа Строка, указывается только при чтении объектов JSON,

<Значение> - значение допустимого для сериализации типа,

<ДополнительныеПараметры>.

Возвращаемое значение - произвольного типа.

Если данный параметр задан и не задан параметр <МодульФункцииВосстановления>, и наоборот, будет вызвано исключение.

Если функция не установлена, то при вызове метода ПрочитатьJSON параметр <ИменаСвойствСоЗначениямиДата> игнорируется.

Значение по умолчанию: Неопределено.

<МодульФункцииВосстановления> (необязательный)

Тип: Произвольный. 

Указывает модуль, процедура которого будет использована для восстановления значения.

Значение по умолчанию: Неопределено.

<ДополнительныеПараметрыФункцииВосстановления> (необязательный)

Тип: Произвольный. 

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

Значение по умолчанию: Неопределено.

<ИменаСвойствДляОбработкиВосстановления> (необязательный)

Тип: Массив. 

Массив имен свойств JSON, для которых будет вызвана функция восстановления.

Параметр игнорируется, если не установлен параметр ИмяФункцииВосстановления.

Значение по умолчанию: Неопределено.

<МаксимальнаяВложенность> (необязательный)

Тип: Число. 

Максимальный уровень вложенности объекта JSON.

При превышении уровня вложенности будет сгенерировано исключение.

Значение по умолчанию: 500.

Возвращаемое значение:

Тип: Произвольный. 

Описание:

Считывает значение из JSON-текста или файла. JSON-текст должен быть корректным.

Доступность:

Тонкий клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер, интеграция.

Примечание:

Массив будет десериализован в массив. Объект JSON будет преобразован в соответствие или структуру (если ключ структуры окажется недопустимым, будет вызвано исключение).

Для дат действует аналогично методу ПрочитатьДатуJSON.

Во время выполнения метода может быть вызвана пользовательская функция для восстановления значения - для этого следует использовать параметр <ИмяФункцииВосстановления>. Функция восстановления должна быть описана с директивой &НаСервере или &НаКлиенте. Использование функции вне контекста не допускается.

Использование в версии:

Доступен, начиная с версии 8.3.6.

     Методическая информация