Convertissez du JSON en class Dart !

Saisissez du JSON pour générer du code class Dart, objets imbriqués compris ! Compatible avec Flutter, fromJson, toJson.
JSON
Résultat
 

Convertissez du JSON en class Dart !

Transforme du JSON en classes Dart dotées d'une factory fromJson et d'une méthode toJson. Le code est du Dart pur, sans package de génération de code, donc sans étape build_runner.

Idéal pour les applications Flutter qui font transiter des réponses brutes Map<String, dynamic> de http ou dio jusqu'aux widgets et veulent de vraies classes de modèle à la place, ou pour les petits projets qui ont besoin d'une sérialisation fonctionnelle avant d'adopter json_serializable.

Mode d'emploi

  1. Collez le JSON à convertir.
  2. Saisissez le nom de la classe de premier niveau dans Nom du type (par exemple Store).
  3. Collez la sortie dans un fichier sous lib/models/ ; aucun import n'est nécessaire.
  4. Créez les objets avec Store.fromJson(jsonDecode(response.body) as Map<String, dynamic>) et envoyez-les avec jsonEncode(store.toJson()).

Exemple

Entrée (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 }
  ]
}
Sortie (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,
      };
}

Les éléments du tableau menuItems deviennent une classe MenuItem, convertie dans fromJson avec .map(...).toList(). rating est lu via (json['rating'] as num).toDouble(), ce qui reste sûr avec une valeur entière, et spicy, présent seulement sur certains plats, est un int? sans required dans le constructeur.

Fonctionnalités prises en charge

  • Tous les champs sont final ; les constructeurs utilisent des paramètres nommés ({required this.x}).
  • factory X.fromJson(Map<String, dynamic> json) et Map<String, dynamic> toJson() écrits comme à la main, sans dépendance à un package.
  • Les objets imbriqués et tableaux d'objets appellent le fromJson / toJson de la classe enfant.
  • Les champs double sont lus via (as num).toDouble() : un entier JSON comme 4 ne provoque pas d'erreur de cast.
  • Les champs absents de certains éléments ou contenant null deviennent nullables (int?) et laissent passer null dans fromJson.
  • Les valeurs de type mixte sont dynamic ; les mots réservés Dart comme class ou is reçoivent un tiret bas final.
  • Un tableau de premier niveau produit typedef Root = List<RootItem>;.

Cas d'utilisation

Modèles d'API pour les écrans Flutter

Faire circuler une Map dans un FutureBuilder ou un state Riverpod/Bloc masque les fautes de frappe sur les clés jusqu'à l'exécution. Avec les classes générées, vous avez la complétion et la vérification de types sur store.menuItems.first.price.

Cache local

Stockez jsonEncode(store.toJson()) dans shared_preferences ou un fichier et restaurez-le avec fromJson au démarrage : un cache en quelques lignes.

Un brouillon avant json_serializable

Validez d'abord la liste des champs et leurs types ; quand le projet grandit, ajoutez @JsonSerializable() sur les mêmes champs et passez à la génération de code.

Remarques et limites

  • Les types sont inférés avec le parseur JSON du navigateur, qui lit 5000.0 comme l'entier 5000. Le jsonDecode de Dart garde 5000.0 en double, et as int lève alors une exception. Passez en double les champs de prix ou de coordonnées susceptibles de porter une décimale.
  • toJson écrit les champs nullables même quand ils valent null ('spicy': null). Si votre serveur refuse les clés nulles, omettez-les conditionnellement.
  • Les chaînes de date restent String ; convertissez-les vous-même avec DateTime.parse(json['createdAt'] as String).
  • Pas de génération de copyWith, ==/hashCode ni toString. Envisagez freezed ou equatable si vous en avez besoin.
  • Les champs dynamic contiennent des valeurs non vérifiées ; remplacez-les une fois le vrai type connu.

FAQ

Peut-il générer du code json_serializable ou freezed ?

La sortie est un fromJson/toJson de style manuel, sans package. Reprenez les déclarations de champs, ajoutez @JsonSerializable() et part 'store.g.dart';, puis lancez dart run build_runner build pour passer à la génération de code.

J'obtiens type 'int' is not a subtype of type 'double'.

Cela arrive quand le code caste avec as double alors que la valeur JSON est un entier. Les champs double générés utilisent (as num).toDouble() pour l'éviter ; appliquez le même motif à tout champ modifié à la main.

Comment décoder une réponse liste ([ {...}, {...} ]) ?

Un tableau de premier niveau produit un typedef et une classe d'élément. Appelez fromJson pour chaque élément : (jsonDecode(body) as List<dynamic>).map((e) => RootItem.fromJson(e as Map<String, dynamic>)).toList().

Est-ce que ça marche dans d'anciens projets sans null safety ?

La sortie utilise la syntaxe de sound null safety (int?, required) disponible depuis Dart 2.12. Les projets antérieurs à la null safety doivent retirer les ? et required pour compiler.