Преобразуйте JSON в class Dart!

Введите JSON, чтобы получить код class на Dart, включая вложенные объекты! Поддержка: Flutter, fromJson, toJson.
JSON
Результат
 

Преобразуйте JSON в class Dart!

Превращает JSON в классы Dart с фабрикой fromJson и методом toJson. Код написан на чистом Dart без пакетов кодогенерации, так что шага build_runner нет.

Подходит для Flutter-приложений, которые передают в виджеты сырые ответы Map<String, dynamic> от http или dio и хотят вместо этого нормальные классы моделей, а также для небольших проектов, которым нужна рабочая сериализация до перехода на json_serializable.

Как пользоваться

  1. Вставьте JSON для преобразования.
  2. Введите имя класса верхнего уровня в Имя типа (например, Store).
  3. Вставьте вывод в файл в lib/models/; импорты не нужны.
  4. Создавайте объекты через Store.fromJson(jsonDecode(response.body) as Map<String, dynamic>) и отправляйте через jsonEncode(store.toJson()).

Пример

Вход (JSON)
{
  "storeId": 77,
  "storeName": "Mapo Kimbap",
  "isOpen": true,
  "rating": 4.7,
  "menuItems": [
    { "name": "Tuna Kimbap", "price": 4500, "soldOut": false },
    { "name": "Ramyeon", "price": 5000, "soldOut": true, "spicy": 2 }
  ]
}
Результат (Dart)
class Store {
  final int storeId;
  final String storeName;
  final bool isOpen;
  final double rating;
  final List<MenuItem> menuItems;

  Store({
    required this.storeId,
    required this.storeName,
    required this.isOpen,
    required this.rating,
    required this.menuItems,
  });

  factory Store.fromJson(Map<String, dynamic> json) => Store(
        storeId: json['storeId'] as int,
        storeName: json['storeName'] as String,
        isOpen: json['isOpen'] as bool,
        rating: (json['rating'] as num).toDouble(),
        menuItems: (json['menuItems'] as List<dynamic>).map((e) => MenuItem.fromJson(e as Map<String, dynamic>)).toList(),
      );

  Map<String, dynamic> toJson() => {
        'storeId': storeId,
        'storeName': storeName,
        'isOpen': isOpen,
        'rating': rating,
        'menuItems': menuItems.map((e) => e.toJson()).toList(),
      };
}

class MenuItem {
  final String name;
  final int price;
  final bool soldOut;
  final int? spicy;

  MenuItem({
    required this.name,
    required this.price,
    required this.soldOut,
    this.spicy,
  });

  factory MenuItem.fromJson(Map<String, dynamic> json) => MenuItem(
        name: json['name'] as String,
        price: json['price'] as int,
        soldOut: json['soldOut'] as bool,
        spicy: json['spicy'] as int?,
      );

  Map<String, dynamic> toJson() => {
        'name': name,
        'price': price,
        'soldOut': soldOut,
        'spicy': spicy,
      };
}

Элементы массива menuItems становятся классом MenuItem, который преобразуется внутри fromJson через .map(...).toList(). rating читается как (json['rating'] as num).toDouble(), так что целое значение тоже безопасно, а spicy, который есть только у части пунктов меню, имеет тип int? и не помечен required в конструкторе.

Возможности

  • Все поля final; конструкторы используют именованные параметры ({required this.x}).
  • Написанные «вручную» factory X.fromJson(Map<String, dynamic> json) и Map<String, dynamic> toJson() без зависимостей от пакетов.
  • Вложенные объекты и массивы объектов вызывают fromJson / toJson дочернего класса.
  • Поля double читаются через (as num).toDouble(), поэтому целое число JSON вроде 4 не вызывает ошибку приведения типа.
  • Поля, отсутствующие в части элементов или содержащие null, становятся nullable (int?) и в fromJson пропускают null как есть.
  • Значения смешанного типа — dynamic; зарезервированные слова Dart вроде class или is получают подчёркивание в конце.
  • Массив верхнего уровня даёт typedef Root = List<RootItem>;.

Сценарии использования

API-модели для экранов Flutter

Когда через FutureBuilder или состояние Riverpod/Bloc передаётся Map, опечатки в ключах всплывают только во время выполнения. Со сгенерированными классами вы получаете автодополнение и проверку типов для store.menuItems.first.price.

Локальное кеширование

Сохраните jsonEncode(store.toJson()) в shared_preferences или в файл и восстановите через fromJson при запуске — кеш в несколько строк.

Черновик до json_serializable

Сначала зафиксируйте список полей и типы; когда проект вырастет, добавьте к тем же полям @JsonSerializable() и переходите на кодогенерацию.

Примечания и ограничения

  • Типы выводятся JSON-парсером браузера, который читает 5000.0 как целое 5000. jsonDecode в Dart сохраняет 5000.0 как double, и as int выбрасывает исключение. Поля цен или координат, где может появиться десятичная точка, поменяйте на double.
  • toJson записывает nullable-поля, даже когда они null ('spicy': null). Если сервер отвергает null-ключи, исключайте их по условию.
  • Строки с датами остаются String; преобразуйте их сами через DateTime.parse(json['createdAt'] as String).
  • copyWith, ==/hashCode и toString не генерируются. Если они нужны, присмотритесь к freezed или equatable.
  • Поля dynamic хранят значения без проверки; замените их, когда узнаете реальный тип.

Частые вопросы

Может ли он сгенерировать код json_serializable или freezed?

Вывод — это fromJson/toJson в рукописном стиле без пакетов. Возьмите объявления полей, добавьте @JsonSerializable() и part 'store.g.dart';, затем запустите dart run build_runner build, чтобы перейти на кодогенерацию.

Получаю type 'int' is not a subtype of type 'double'.

Так бывает, когда код приводит тип через as double, а значение в JSON целое. Сгенерированные поля double используют (as num).toDouble(), чтобы этого избежать; примените тот же шаблон к полям, которые правили вручную.

Как декодировать ответ-список ([ {...}, {...} ])?

Массив верхнего уровня даёт typedef и класс элемента. Вызывайте fromJson для каждого элемента: (jsonDecode(body) as List<dynamic>).map((e) => RootItem.fromJson(e as Map<String, dynamic>)).toList().

Работает ли это в старых проектах без null safety?

Вывод использует синтаксис sound null safety (int?, required) начиная с Dart 2.12. В проектах до null safety для компиляции нужно убрать ? и required.