Перейти к основному содержимому

НастройкиЧтенияОбъектовJson

Стд::Json::НастройкиЧтенияОбъектовJson Доступность: Сервер

Объект, содержащий настройки чтения объектов JSON целиком.

Сравнение ссылочное

Иерархия типа​

Базовые типы: Объект

Конструкторы​

НастройкиЧтенияОбъектовJson​

Доступность: Сервер

НастройкиЧтенияОбъектовJson()

Конструктор настроек для чтения объектов JSON целиком по умолчанию.

Свойства​

ИгнорироватьЛишниеЧастиДатыВремени​

Доступность: Сервер

ИгнорироватьЛишниеЧастиДатыВремени: Булево

Признак игнорирования лишних частей дата-времени при чтении в типы Дата и Время.

ИгнорироватьНеизвестныеСвойства​

Доступность: Сервер

ИгнорироватьНеизвестныеСвойства: Булево?

Признак игнорирования неизвестных (лишних) полей в тексте JSON. Если поведение не задано явно с помощью аннотации, то Неопределено трактуется как [Ложь]

Может быть полезно, например, когда для обращения к REST-сервису используется JSON, и у сервиса был изменен API, добавив новое свойство. При чтении, иначе, будет выброшено ИсключениеЧтенияJson, поскольку в объявленной структуре нет нового свойства.

ИнициализироватьОтсутствующиеПоля​

Доступность: Сервер

ИнициализироватьОтсутствующиеПоля: Булево?

Инициализировать отсутствующие поля структур явными значениями инициализации. По умолчанию признак не активен, если он не включен явно или с помощью аннотации. Значение Неопределено имеет приоритет над значением инициализации.

Примеры​

{
  "поле": "Значение из JSON",
  "поле2": null
}
структура Структура
    пер поле: Строка
    пер поле2: Строка? = "Значение по умолчанию"
    пер поле3: Строка? = "Значение по умолчанию"
    пер поле4: Строка = "Значение по умолчанию"
    пер поле5: Строка?
;

метод ПрочитатьСтруктуруСУчетомИнициализацииОтсутствующихПолей(ТекстJson: Строка)
    пер Настройки = новый НастройкиЧтенияОбъектовJson()
    Настройки.ИнициализироватьОтсутствующиеПоля = Истина

    // значение: {поле=Значение из JSON, поле2=undefined, поле3=undefined, 
    //              поле4=Значение по умолчанию, поле5=undefined}
    пер Результат = СериализацияJson.ПрочитатьОбъект(ТекстJson, Тип<Структура>, Настройки)
;

ИнициализироватьПустыеКоллекции​

Доступность: Сервер

ИнициализироватьПустыеКоллекции: Булево?

Инициализировать пустые коллекции полей структур, если при чтении из JSON отсутствует значение. Если поведение не задано явно с помощью аннотации, то Неопределено трактуется как [Ложь]

ПсевдонимыСвойств​

Доступность: Сервер

ПсевдонимыСвойств: ЧитаемоеСоответствие<Тип, Соответствие<Строка, Множество<Строка>>>

Псевдонимы для имени свойства JSON для свойств типа.

Примеры​

{
  "num_field": 32,
  "field_bool": false
}
структура Структура
    пер число: Число
    пер булево: Булево
;

метод ЧтениеСтруктурыСПсевдонимамиПолей(ТекстJson: Строка)
    знч Настройки = новый НастройкиЧтенияОбъектовJson()
    Настройки.ИгнорироватьНеизвестныеСвойства = Ложь
    Настройки.ПсевдонимыСвойств= {
        Тип<Структура> : {
            "число": {"field_num", "num_field"},
            "булево": {"bool_field", "field_bool"}
        }
    }

    знч Результат = СериализацияJson.ПрочитатьОбъект(ТекстJson, Тип<Структура>, Настройки)
;

Список унаследованных методов​

Объект​

ВСтроку, ПолучитьТип, Представление

Последнее обновление