Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
Flutter

Modèles Dart et sérialisation JSON

Transformer le JSON en objets Dart typés avec fromJson et toJson, modèles imbriqués et pièges classiques....

0 chapitres 0 QCM Accès gratuit

À propos de ce cours

Transformer le JSON en objets Dart typés avec fromJson et toJson, modèles imbriqués et pièges classiques.

Problème : manipuler response['title'] partout est fragile. Une faute de frappe ('titel') ne provoque aucune erreur à la compilation, seulement un plantage à l'exécution. La solution : une classe modèle qui convertit le JSON en objet Dart typé.

  • Désérialiser = JSON → objet Dart (fromJson), quand on reçoit des données.
  • Sérialiser = objet Dart → JSON (toJson), quand on envoie des données.

Un modèle simple : Todo

class Todo {
  final int id;
  final int userId;
  final String title;
  final bool completed;

  const Todo({
    required this.id,
    required this.userId,
    required this.title,
    required this.completed,
  });

  // JSON -> Todo
  factory Todo.fromJson(Map<String, dynamic> json) {
    return Todo(
      id: json['id'] as int,
      userId: json['userId'] as int,
      title: json['title'] as String,
      completed: json['completed'] as bool? ?? false, // valeur par défaut si absent
    );
  }

  // Todo -> JSON
  Map<String, dynamic> toJson() => {
        'id': id,
        'userId': userId,
        'title': title,
        'completed': completed,
      };
}

Convertir une liste

Future<List<Todo>> fetchTodos() async {
  final response = await http.get(
    Uri.parse('https://jsonplaceholder.typicode.com/todos?_limit=20'),
  );
  if (response.statusCode != 200) throw Exception('Erreur ${response.statusCode}');

  final List<dynamic> data = jsonDecode(response.body);
  return data.map((e) => Todo.fromJson(e as Map<String, dynamic>)).toList();
}

Un modèle imbriqué : la météo

La réponse d'Open-Meteo contient un objet current à l'intérieur de l'objet principal. On crée un modèle par niveau.

class CurrentWeather {
  final DateTime time;
  final double temperature;
  final double windSpeed;

  CurrentWeather({required this.time, required this.temperature, required this.windSpeed});

  factory CurrentWeather.fromJson(Map<String, dynamic> json) => CurrentWeather(
        time: DateTime.parse(json['time'] as String),
        // num -> double : l'API peut renvoyer 9 (int) ou 9.4 (double)
        temperature: (json['temperature_2m'] as num).toDouble(),
        windSpeed: (json['wind_speed_10m'] as num).toDouble(),
      );
}

class WeatherResponse {
  final double latitude;
  final double longitude;
  final CurrentWeather current;

  WeatherResponse({required this.latitude, required this.longitude, required this.current});

  factory WeatherResponse.fromJson(Map<String, dynamic> json) => WeatherResponse(
        latitude: (json['latitude'] as num).toDouble(),
        longitude: (json['longitude'] as num).toDouble(),
        current: CurrentWeather.fromJson(json['current'] as Map<String, dynamic>),
      );
}

Pièges classiques

Erreur affichée Cause Solution
type 'int' is not a subtype of type 'double' L'API renvoie 9 au lieu de 9.0 (json['x'] as num).toDouble()
type 'Null' is not a subtype of type 'String' Champ absent ou null Type nullable String? ou valeur par défaut ?? ''
type 'List<dynamic>' is not a subtype of 'Map<String, dynamic>' La réponse est un tableau, pas un objet Utiliser List puis .map(...)
Accents illisibles (é) Encodage mal interprété jsonDecode(utf8.decode(response.bodyBytes))

Pour aller plus loin : générer le code automatiquement

Sur de gros projets, on n'écrit pas fromJson à la main :

  • les packages json_serializable + build_runner génèrent fromJson / toJson à partir d'annotations ;
  • freezed ajoute en plus l'immutabilité, copyWith et l'égalité ;
  • des outils en ligne (« JSON to Dart », quicktype) transforment un exemple de JSON en classe Dart. Pratique, mais relisez toujours le code produit.

Activité 24.4 — « Modéliser un utilisateur » (40 min)

  1. Ouvrez https://jsonplaceholder.typicode.com/users/1 et observez la structure : l'utilisateur contient un objet address (lui-même avec geo) et un objet company.
  2. Écrivez les classes User, Address et Company avec fromJson et toJson.
  3. Écrivez Future<List<User>> fetchUsers() et affichez dans la console le nom et la ville de chaque utilisateur.
  4. Question de réflexion : quel est l'intérêt d'avoir user.address.city plutôt que json['address']['city']? (indice : autocomplétion, erreurs détectées à la compilation).

Cet article vous a-t-il aidé ?