¡Convierte JSON en class de Dart!

¡Introduce JSON para generar código class de Dart, incluidos los objetos anidados! Compatible con Flutter, fromJson, toJson.
JSON
Resultado
 

¡Convierte JSON en class de Dart!

Convierte JSON en clases Dart con un factory fromJson y un método toJson. El código es Dart puro sin paquetes de generación de código, así que no hay paso de build_runner.

Encaja en apps Flutter que pasan respuestas crudas Map<String, dynamic> de http o dio a los widgets y quieren clases de modelo de verdad, o en proyectos pequeños que necesitan una serialización funcional antes de adoptar json_serializable.

Cómo usar

  1. Pega el JSON que quieres convertir.
  2. Escribe el nombre de la clase de nivel superior en Nombre del tipo (por ejemplo Store).
  3. Pega la salida en un archivo dentro de lib/models/; no hacen falta imports.
  4. Crea objetos con Store.fromJson(jsonDecode(response.body) as Map<String, dynamic>) y envíalos con jsonEncode(store.toJson()).

Ejemplo

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 }
  ]
}
Salida (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,
      };
}

Los elementos del array menuItems pasan a ser una clase MenuItem, convertida dentro de fromJson con .map(...).toList(). rating se lee como (json['rating'] as num).toDouble(), así que un valor entero sigue siendo seguro, y spicy, presente solo en algunos platos del menú, es int? sin required en el constructor.

Funciones compatibles

  • Todos los campos son final; los constructores usan parámetros con nombre ({required this.x}).
  • factory X.fromJson(Map<String, dynamic> json) y Map<String, dynamic> toJson() escritos a mano, sin dependencias de paquetes.
  • Los objetos anidados y los arrays de objetos llaman al fromJson / toJson de la clase hija.
  • Los campos double se leen mediante (as num).toDouble(), así que un entero JSON como 4 no lanza un error de cast.
  • Los campos que faltan en algunos elementos o contienen null pasan a nullable (int?) y dejan pasar null en fromJson.
  • Los valores de tipo mixto son dynamic; las palabras reservadas de Dart como class o is reciben un guion bajo al final.
  • Un array de nivel superior produce typedef Root = List<RootItem>;.

Casos de uso

Modelos de API para pantallas Flutter

Arrastrar un Map por FutureBuilder o por el estado de Riverpod/Bloc esconde las erratas en las claves hasta el runtime. Con clases generadas tienes autocompletado y comprobación de tipos en store.menuItems.first.price.

Caché local

Guarda jsonEncode(store.toJson()) en shared_preferences o en un archivo y restáuralo con fromJson al arrancar para tener una caché en pocas líneas.

Un borrador antes de json_serializable

Confirma primero la lista de campos y sus tipos; cuando el proyecto crezca, añade @JsonSerializable() a esos mismos campos y pasa a la generación de código.

Notas y limitaciones

  • Los tipos se infieren con el parser JSON del navegador, que lee 5000.0 como el entero 5000. jsonDecode de Dart mantiene 5000.0 como double, así que as int lanza una excepción. Cambia a double los campos de precio o coordenadas que puedan llevar punto decimal.
  • toJson escribe los campos nullable aunque sean null ('spicy': null). Si tu servidor rechaza claves null, omítelas de forma condicional.
  • Las cadenas de fecha se quedan como String; conviértelas tú con DateTime.parse(json['createdAt'] as String).
  • No se generan copyWith, ==/hashCode ni toString. Plantéate freezed o equatable si los necesitas.
  • Los campos dynamic guardan valores sin comprobar; sustitúyelos cuando conozcas el tipo real.

Preguntas frecuentes

¿Puede generar código de json_serializable o freezed?

La salida es fromJson/toJson al estilo escrito a mano, sin paquetes. Toma las declaraciones de campos, añade @JsonSerializable() y part 'store.g.dart';, y ejecuta dart run build_runner build para pasar a la generación de código.

Me sale type 'int' is not a subtype of type 'double'.

Ocurre cuando el código hace cast con as double y el valor JSON es un entero. Los campos double generados usan (as num).toDouble() para evitarlo; aplica el mismo patrón a cualquier campo que hayas editado a mano.

¿Cómo decodifico una respuesta de lista ([ {...}, {...} ])?

Un array de nivel superior genera un typedef y una clase de elemento. Llama a fromJson por cada elemento: (jsonDecode(body) as List<dynamic>).map((e) => RootItem.fromJson(e as Map<String, dynamic>)).toList().

¿Funciona en proyectos antiguos sin null safety?

La salida usa la sintaxis de sound null safety (int?, required) de Dart 2.12 en adelante. Los proyectos anteriores a null safety necesitan quitar los ? y required para compilar.