СериализацияJson
Тип-одиночка Стд::Json::СериализацияJson Базовые типы: Объект |
Иерархия типа
graph TD;
СериализацияJson-->Объект;
Методы для чтения и записи объектов JSON целиком.
Сравнение ссылочное
Методы
ЗаписатьОбъект
ЗаписатьОбъект(
Значение: Объект?,
Настройки: НастройкиЗаписиОбъектовJson
): Строка
Перегрузка: ЗаписатьОбъект(Поток: ПотокЗаписи, Значение: Объект?, Настройки: НастройкиЗаписиОбъектовJson) |
Записывает объект Значение
в JSON с настройками Настройки
и возвращает результат. Можно записывать объекты любого типа объявленного в коде (структура, перечисление) и некоторых встроенных типов:
- Коллекция:
- Соответствие,
- Строка,
- Число,
- Булево,
- Момент,
- ДатаВремя,
- Дата,
- Время,
- Длительность,
- Версия,
- Перечисление,
- Байты.
Сопоставление типов происходит точно так же, как описано в методе ПрочитатьОбъект.
ЗаписатьОбъект
ЗаписатьОбъект(
Поток: ПотокЗаписи,
Значение: Объект?,
Настройки: НастройкиЗаписиОбъектовJson)
Перегрузка: ЗаписатьОбъект(Значение: Объект?, Настройки: НастройкиЗаписиОбъектовJson): Строка |
Записывает объект Значение
в JSON с настройками Настройки
в поток Поток
. Можно записывать объекты любого типа объявленного в коде (структура, перечисление) и некоторых встроенных типов:
- Коллекция:
- Соответствие,
- Строка,
- Число,
- Булево,
- Момент,
- ДатаВремя,
- Дата,
- Время,
- Длительность,
- Версия,
- Перечисление,
- Байты.
Сопоставление типов происходит точно так же, как описано в методе ПрочитатьОбъект.
ПрочитатьМассив
Читает массив объектов из Источник
. Вызывает метод ПрочитатьОбъект с параметром Тип = Тип<Массив<Объект>>) и кодировкой `Кодировка`.Объект>
ПрочитатьОбъект
ПрочитатьОбъект(
Источник: ПотокЧтения|Строка,
Тип: Тип|Коллекция<Тип>,
Настройки: НастройкиЧтенияОбъектовJson,
Кодировка: Кодировка|Строка = Кодировка.Utf8
): Объект?
Считывает объект JSON из Источник
в объект типа Тип
с настройками Настройки
и кодировкой Кодировка
. Можно читать объекты любого типа, объявленного в коде (структура, перечисление), и некоторых встроенных типов:
- Коллекция:
- Соответствие,
- Строка,
- Число,
- Булево,
- Момент,
- ДатаВремя,
- Дата,
- Время,
- Длительность,
- Версия,
- Перечисление,
- Байты.
Если значение типа/типов объекта не указано, тогда чтение выполняется в Соответствие.
Сопоставление полей и свойств происходит следующим образом:
true
,false
- отображаются в Булево,"Любая строка"
- отображается в Строка,- Любое число, (1, 1.56, 0) - отображается в Число
- Объект
{ ... }
- отображается в структуру либо в Соответствие, - Массив
[ ... ]
- отображается в Массив или Множество, - Строка в формате Момент или ДатаВремя отображается в Момент или ДатаВремя,
- Строка в формате Версия отображается в Версия.
Имя свойства в структуре сопоставляется с именем свойства в исходном JSON.
Если необходимого поля структуры нет в читаемом тексте JSON, тогда значение поле устанавливается в Неопределено
.
ПрочитатьСоответствие
ПрочитатьСоответствие(
Источник: ПотокЧтения|Строка,
Кодировка: Кодировка|Строка = Кодировка.Utf8
): Соответствие<Строка, Объект?>
Читает соответствие из Источник
. Вызывает метод ПрочитатьОбъект с параметром Тип = Тип<Соответствие<Строка, Объект?») и кодировкой Кодировка
.