Converta JSON em class Dart!

Insira JSON para gerar código class Dart, incluindo objetos aninhados! Compatível com Flutter, fromJson, toJson.
JSON
Resultado
 

Converta JSON em class Dart!

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.

Como usar

  1. Cole o JSON a converter.
  2. Informe o nome da classe de nível mais alto em Nome do tipo (por exemplo Store).
  3. Cole a saída num arquivo em lib/models/; não precisa de imports.
  4. Crie objetos com Store.fromJson(jsonDecode(response.body) as Map<String, dynamic>) e envie com jsonEncode(store.toJson()).

Exemplo

Entrada (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 }
  ]
}
Saída (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,
      };
}

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.

Recursos suportados

  • Todos os campos são 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.
  • Objetos aninhados e arrays de objetos chamam o fromJson / toJson da classe filha.
  • Campos double são lidos via (as num).toDouble(), então um inteiro JSON como 4 não gera erro de cast.
  • Campos que faltam em alguns itens ou contêm null viram nullable (int?) e repassam null no fromJson.
  • Valores de tipo misto são dynamic; palavras reservadas do Dart como class ou is ganham um underscore no final.
  • Um array no nível mais alto gera typedef Root = List<RootItem>;.

Casos de uso

Models de API para telas Flutter

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.

Cache local

Salve jsonEncode(store.toJson()) no shared_preferences ou num arquivo e restaure com fromJson na inicialização, para ter um cache em poucas linhas.

Um rascunho antes do json_serializable

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.

Observações e limitações

  • Os tipos são inferidos com o parser JSON do navegador, que lê 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.
  • O toJson escreve campos nullable mesmo quando são null ('spicy': null). Se o seu servidor rejeita chaves nulas, deixe-as de fora condicionalmente.
  • Strings de data continuam String; converta você mesmo com DateTime.parse(json['createdAt'] as String).
  • Não são gerados copyWith, ==/hashCode nem toString. Considere o freezed ou o equatable se precisar deles.
  • Campos dynamic guardam valores sem checagem; troque-os quando souber o tipo real.

Perguntas frequentes

Ele gera código para json_serializable ou freezed?

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.

Recebo 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.

Como decodifico uma resposta em lista ([ {...}, {...} ])?

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().

Funciona em projetos antigos sem null safety?

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.