Transforma JSON em classes Dart com uma factory fromJson e um método toJson. O código é Dart puro, sem pacotes de geração de código, então não há etapa de build_runner.
Combina com apps Flutter que passam respostas cruas Map<String, dynamic> do http ou do dio para os widgets e querem classes de model de verdade, ou com projetos pequenos que precisam de serialização funcionando antes de adotar o json_serializable.
Nome do tipo (por exemplo Store).lib/models/; não precisa de imports.Store.fromJson(jsonDecode(response.body) as Map<String, dynamic>) e envie com 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,
};
}
Os elementos do array menuItems viram uma classe MenuItem, convertida dentro do fromJson com .map(...).toList(). rating é lido como (json['rating'] as num).toDouble(), então um valor inteiro continua seguro, e spicy, presente só em alguns itens do menu, é int? sem required no construtor.
final; os construtores usam parâmetros nomeados ({required this.x}).factory X.fromJson(Map<String, dynamic> json) e Map<String, dynamic> toJson() escritos à mão, sem dependência de pacotes.fromJson / toJson da classe filha.double são lidos via (as num).toDouble(), então um inteiro JSON como 4 não gera erro de cast.null viram nullable (int?) e repassam null no fromJson.dynamic; palavras reservadas do Dart como class ou is ganham um underscore no final.typedef Root = List<RootItem>;.Carregar um Map pelo FutureBuilder ou pelo state do Riverpod/Bloc esconde erros de digitação nas chaves até o runtime. Com as classes geradas você tem autocomplete e checagem de tipos em store.menuItems.first.price.
Salve jsonEncode(store.toJson()) no shared_preferences ou num arquivo e restaure com fromJson na inicialização, para ter um cache em poucas linhas.
Confirme primeiro a lista de campos e os tipos; conforme o projeto cresce, adicione @JsonSerializable() nos mesmos campos e passe para geração de código.
5000.0 como o inteiro 5000. O jsonDecode do Dart mantém 5000.0 como double, então as int lança exceção. Troque para double campos de preço ou de coordenadas que possam vir com ponto decimal.toJson escreve campos nullable mesmo quando são null ('spicy': null). Se o seu servidor rejeita chaves nulas, deixe-as de fora condicionalmente.String; converta você mesmo com DateTime.parse(json['createdAt'] as String).copyWith, ==/hashCode nem toString. Considere o freezed ou o equatable se precisar deles.dynamic guardam valores sem checagem; troque-os quando souber o tipo real.A saída é fromJson/toJson no estilo escrito à mão, sem pacotes. Pegue as declarações de campo, adicione @JsonSerializable() e part 'store.g.dart'; e rode dart run build_runner build para passar para geração de código.
type 'int' is not a subtype of type 'double'.Isso acontece quando o código faz cast com as double e o valor no JSON é inteiro. Os campos double gerados usam (as num).toDouble() para evitar isso; aplique o mesmo padrão em qualquer campo que você editou à mão.
[ {...}, {...} ])?Um array no nível mais alto gera um typedef e uma classe de elemento. Chame fromJson para cada elemento: (jsonDecode(body) as List<dynamic>).map((e) => RootItem.fromJson(e as Map<String, dynamic>)).toList().
A saída usa a sintaxe de sound null safety (int?, required) do Dart 2.12 em diante. Projetos anteriores ao null safety precisam remover os ? e os required para compilar.