À 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_runnergénèrentfromJson/toJsonà partir d'annotations ; freezedajoute en plus l'immutabilité,copyWithet 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)
- Ouvrez
https://jsonplaceholder.typicode.com/users/1et observez la structure : l'utilisateur contient un objetaddress(lui-même avecgeo) et un objetcompany. - Écrivez les classes
User,AddressetCompanyavecfromJsonettoJson. - Écrivez
Future<List<User>> fetchUsers()et affichez dans la console le nom et la ville de chaque utilisateur. - Question de réflexion : quel est l'intérêt d'avoir
user.address.cityplutôt quejson['address']['city']? (indice : autocomplétion, erreurs détectées à la compilation).
Cet article vous a-t-il aidé ?
Merci pour votre avis sur cet article 🙏
Merci, votre message nous a bien été transmis 🙏
Cette leçon vous a été utile ? Partagez-la !