JSON в Dart Class

Генерируйте Dart-классы для Flutter из JSON прямо в браузере.

Class name:

JSON

Dart Class

class Address {
  final String city;
  final String zip;

  const Address({
    required this.city,
    required this.zip,
  });

  factory Address.fromJson(Map<String, dynamic> json) =>
      Address(
    city: json['city'] as String,
    zip: json['zip'] as String,
      );

  Map<String, dynamic> toJson() => {
      'city': city,
      'zip': zip,
      };
}

class User {
  final String name;
  final int age;
  final List<String> skills;
  final Address address;

  const User({
    required this.name,
    required this.age,
    required this.skills,
    required this.address,
  });

  factory User.fromJson(Map<String, dynamic> json) =>
      User(
    name: json['name'] as String,
    age: json['age'] as int,
    skills: (json['skills'] as List<dynamic>).cast<dynamic>(),
    address: Address.fromJson(json['address'] as Map<String, dynamic>),
      );

  Map<String, dynamic> toJson() => {
      'name': name,
      'age': age,
      'skills': skills,
      'address': address.toJson(),
      };
}

Processed in your browser

Для чего это нужно

JSON в Dart-класс для Flutter

Готово для Flutter

Код совместим с Flutter, json_serializable и freezed. Готов к использованию с http, dio или Riverpod.

100% приватно

Ваш JSON из API обрабатывается только в вашем браузере. Чувствительные данные не покидают устройство.

Корректный null safety

Автоматически определяет nullable-поля. Обязательные типы с required, необязательные с ? — на основе JSON.

Мгновенно

Dart-классы готовы за миллисекунды. Никакой регистрации, ожидания и ограничений.

Как это работает

Три шага — никаких сложностей

Вставьте ваш JSON

Вставьте JSON из вашего API-ответа. Инструмент определяет корректные Dart-типы для каждого поля.

Dart-класс сгенерирован

Вы получаете Dart-класс с null safety, фабричным конструктором fromJson(), методом toJson() и полной типизацией, совместимой с json_serializable.

Интегрируйте во Flutter

Скопируйте сгенерированный класс в ваш Flutter-проект. Работает непосредственно с пакетом http, dio или любым HTTP-клиентом.

FAQ

Остались вопросы?

Что такое пакет json_serializable?

json_serializable — официальный пакет сообщества Dart/Flutter для сериализации JSON с генерацией кода. Вместо написания методов fromJson() и toJson() вручную вы определяете класс с аннотациями @JsonSerializable(), и генератор кода (build_runner) автоматически создаёт методы. Данный инструмент генерирует код, совместимый с json_serializable: структура класса, типы и паттерн factory fromJson точно соответствуют тому, что сгенерировал бы build_runner.

Что такое паттерн factory fromJson?

Паттерн factory fromJson() — стандарт Dart для десериализации JSON. Фабричный конструктор может возвращать существующий экземпляр или создавать новый; в данном случае он принимает Map<String, dynamic> (результат jsonDecode()) и строит объект. Пример: factory User.fromJson(Map<String, dynamic> json) => User(id: json['id'] as int, name: json['name'] as String). Метод toJson() выполняет обратную операцию. Этот паттерн явный, типобезопасный и легко тестируемый.

Как работает null safety в Dart?

Dart 2.12 (2021) ввёл sound null safety — одну из важнейших возможностей языка. С null safety типы не могут быть null по умолчанию: String — всегда ненулевая строка, а String? может быть null. В контексте JSON поля, которые могут отсутствовать или быть null, должны иметь тип nullable (String?, int?). Ключевое слово required в конструкторе указывает, что параметр обязателен. Данный инструмент автоматически определяет, какие поля JSON могут быть null, и генерирует корректную типизацию.

Как интегрировать сгенерированные классы с API во Flutter?

Типичный поток Flutter: 1) HTTP-вызов с http.get() или dio, 2) декодирование JSON с jsonDecode(response.body), 3) передача результирующего Map в фабричный конструктор: final user = User.fromJson(jsonDecode(response.body)). Для списков объектов: final users = (jsonDecode(response.body) as List).map((e) => User.fromJson(e)).toList(). С пакетом dio можно использовать интерцепторы для автоматической трансформации ответов. С Riverpod или BLoC сгенерированные классы используются непосредственно как состояние.

Что такое пакет freezed как альтернатива?

freezed — пакет генерации кода для Dart/Flutter, выходящий за рамки json_serializable. Он генерирует неизменяемые классы с методом copyWith(), union/sealed-паттерном для моделирования состояний (аналог sealed class в Kotlin), автоматическими equals и hashCode, а также интегрированной JSON-сериализацией. Особенно популярен с Riverpod (менеджер состояния, рекомендованный Flutter-сообществом) для моделирования состояния приложения. Связка freezed + Riverpod — один из наиболее распространённых архитектурных паттернов в профессиональном Flutter.