Конвертер JSON в Dart

Как JSON превращается в null-безопасные модели Dart

В официальной документации dart:convert указано, что jsonDecode() создаёт совместимые с JSON значения: числа, строки, логические значения, null, списки и карты со строковыми ключами. Класс модели нельзя напрямую закодировать в JSON, но jsonEncode() может вызвать его метод toJson(). Этот конвертер создаёт такую схему ручной сериализации без аннотаций json_serializable и зависимостей от пакетов.

Предположим, что образец содержит пользователя с вложенным адресом. Созданный User получит поля final и конструктор с именованными параметрами. User.fromJson(Map<String, Object?> json) приводит скалярные значения к нужным типам и вызывает UserAddress.fromJson() для вложенного объекта. Если address отсутствует или равен null хотя бы в одном объекте образца, его тип становится UserAddress?, а фабричный конструктор проверяет null перед созданием объекта. При включённом toJson вложенные модели рекурсивно преобразуются в карты, которые принимает jsonEncode().

Конвертер проверяет каждый объект корневого массива, а не только первый элемент. Поле становится nullable, если оно отсутствует в одном из элементов или явно равно null. Можно также сделать nullable все поля, если реальный API менее предсказуем, чем образец. В руководстве Dart по null safety отмечено, что по умолчанию типы не допускают null, а для его приёма нужен знак ?.

Обработка идентификаторов и ограничения вывода типов

Ключи JSON не обязаны быть допустимыми именами членов Dart. Знаки пунктуации удаляются, слова преобразуются в lowerCamelCase, зарезервированные слова получают безопасный суффикс, а совпадающие имена получают стабильные числовые суффиксы. Исходный ключ остаётся неизменным в json['original-key'] и карте toJson(). Имена вложенных классов используют полный путь, поэтому несвязанные объекты адресов не объединяются незаметно в один класс.

Один образец не может подтвердить весь контракт API. Строки JSON не распознаются автоматически как даты, UUID или enum, а пустой массив не сообщает тип элемента. Повторяющиеся имена членов объекта также небезопасны для преобразования туда и обратно: парсеры JSON обычно сохраняют последнее значение. Перед использованием в production сравните созданные модели с документацией или схемой API. Инструмент ограничивает размер входных данных, глубину вложенности, число выведенных объявлений и размер результата, чтобы нагрузка на браузер оставалась контролируемой.