Превращает JSON в классы Dart с фабрикой fromJson и методом toJson. Код написан на чистом Dart без пакетов кодогенерации, так что шага build_runner нет.
Подходит для Flutter-приложений, которые передают в виджеты сырые ответы Map<String, dynamic> от http или dio и хотят вместо этого нормальные классы моделей, а также для небольших проектов, которым нужна рабочая сериализация до перехода на json_serializable.
Имя типа (например, Store).lib/models/; импорты не нужны.Store.fromJson(jsonDecode(response.body) as Map<String, dynamic>) и отправляйте через jsonEncode(store.toJson()).{
"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 }
]
}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>;.Когда через FutureBuilder или состояние Riverpod/Bloc передаётся Map, опечатки в ключах всплывают только во время выполнения. Со сгенерированными классами вы получаете автодополнение и проверку типов для store.menuItems.first.price.
Сохраните jsonEncode(store.toJson()) в shared_preferences или в файл и восстановите через fromJson при запуске — кеш в несколько строк.
Сначала зафиксируйте список полей и типы; когда проект вырастет, добавьте к тем же полям @JsonSerializable() и переходите на кодогенерацию.
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 хранят значения без проверки; замените их, когда узнаете реальный тип.Вывод — это 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().
Вывод использует синтаксис sound null safety (int?, required) начиная с Dart 2.12. В проектах до null safety для компиляции нужно убрать ? и required.