JSON in Dart-Klasse
Füge ein JSON-Objekt oder eine API-Antwort ein und erhalte null-sichere Dart-Modellklassen für Flutter: final-Felder, einen Konstruktor mit benannten Parametern, fromJson und toJson, copyWith und eine Klasse für jedes verschachtelte Objekt. Wähle reines Dart oder json_serializable-Annotationen. Alles läuft in deinem Browser.
Zuletzt aktualisiert:
Dein JSON wird lokal in diesem Tab verarbeitet und nie hochgeladen. Tipp: Strg + Eingabe erzeugt den Code.
Anleitung: JSON in Dart-Klasse
- Füge dein JSON in das linke Feld ein oder öffne eine .json-Datei. Ein Beispiel ist geladen, damit du die Ausgabe sofort siehst.
- Benenne die Root-Klasse, zum Beispiel User oder ProductResponse.
- Wähle den Ausgabestil: reines Dart mit handgeschriebenem fromJson/toJson oder json_serializable-Annotationen für build_runner.
- Lege die Optionen fest: welche Felder nullable sind, Feldbenennung, final-Felder, const-Konstruktor, copyWith, toString und DateTime-Parsing.
- Kopiere oder lade die .dart-Datei in dein Flutter-Projekt und rufe User.fromJson(jsonDecode(body)) auf.
Beispiel: JSON in eine Dart-Modellklasse
Aus diesem JSON mit snake_case-Schlüsseln, einem Datum, einem verschachtelten Objekt und einer Liste:
{ "id": 7, "full_name": "Ada", "price": 3.5, "created_at": "2024-05-01T09:30:00Z",
"tags": ["a", "b"], "owner": { "id": 1, "email": null } }sieht die Ausgabe in reinem Dart (hier ohne copyWith) so aus:
class Root {
const Root({
required this.id,
required this.fullName,
required this.price,
required this.createdAt,
required this.tags,
required this.owner,
});
final int id;
final String fullName;
final double price;
final DateTime createdAt;
final List<String> tags;
final Owner owner;
factory Root.fromJson(Map<String, dynamic> json) {
return Root(
id: json['id'] as int,
fullName: json['full_name'] as String,
price: (json['price'] as num).toDouble(),
createdAt: DateTime.parse(json['created_at'] as String),
tags: (json['tags'] as List<dynamic>).cast<String>().toList(),
owner: Owner.fromJson(json['owner'] as Map<String, dynamic>),
);
}
Map<String, dynamic> toJson() {
return {
'id': id,
'full_name': fullName,
'price': price,
'created_at': createdAt.toIso8601String(),
'tags': tags,
'owner': owner.toJson(),
};
}
}Wie JSON-Werte auf Dart-Typen abgebildet werden
| JSON-Wert | Dart-Typ | fromJson-Ausdruck |
|---|---|---|
"Text" | String | json['k'] as String |
42 | int | json['k'] as int |
3.5 (oder gemischt 3 / 3.5) | double | (json['k'] as num).toDouble() |
true | bool | json['k'] as bool |
"2024-05-01T09:30:00Z" | DateTime | DateTime.parse(json['k'] as String) |
"x" oder null | String? | json['k'] as String? |
{ … } | Eine benannte Klasse | Owner.fromJson(json['k'] as Map<String, dynamic>) |
[ { … } ] | List<Item> | .map((e) => Item.fromJson(…)).toList() |
{} | Map<String, dynamic> | json['k'] as Map<String, dynamic> |
Nur null, gemischte Typen | dynamic | json['k'] |
json_serializable einrichten
Wenn du den Stil json_serializable wählst, füge die Pakete hinzu und führe den Codegenerator einmal aus (oder nutze watch während der Entwicklung):
dart pub add json_annotation
dart pub add --dev json_serializable build_runner
dart run build_runner build --delete-conflicting-outputs- Die Zeile
part 'root.g.dart';muss zum Dateinamen deiner Dart-Datei passen. - Klassen, die andere Modellklassen enthalten, erhalten
@JsonSerializable(explicitToJson: true), damit verschachtelte Objekte mit ihrem eigenentoJson()umgewandelt werden, statt als Instanzen zu bleiben. - Felder, deren Dart-Name vom JSON-Schlüssel abweicht, erhalten
@JsonKey(name: 'json_key').
Häufige Fragen
Wie verwende ich die erzeugte Klasse mit einer HTTP-Antwort?
Importiere dart:convert, dekodiere den Body und übergib die Map an die Factory: final user = User.fromJson(jsonDecode(response.body) as Map<String, dynamic>). Um Daten zurückzusenden, rufe jsonEncode(user.toJson()) auf. Ist das JSON ein Array auf oberster Ebene, wandle jedes Element mit fromJson um, wie im erzeugten Kommentar gezeigt.
Welche Felder werden nullable?
Standardmäßig erhält ein Feld einen nullable Typ (zum Beispiel String?), wenn sein Wert irgendwo im Beispiel null ist oder der Schlüssel bei manchen Elementen eines Arrays fehlt. Alle anderen Felder sind nicht nullable und im Konstruktor als required markiert. Du kannst auch alle Felder nullable machen, was bei APIs sicherer ist, die Schlüssel weglassen können.
Warum werden doubles mit (value as num).toDouble() geparst?
jsonDecode liefert ein int für eine Zahl ohne Dezimalpunkt, sodass ein Preis von 3 als int ankommt, auch wenn andere Elemente 3.5 haben. Ein Cast mit as double würde einen Fehler werfen, daher castet der Generator auf num und wandelt mit toDouble() um, was beides akzeptiert.
Reines Dart oder json_serializable: Was soll ich wählen?
Reines Dart braucht weder Pakete noch Codegenerierung und ist leicht zu lesen und zu debuggen. json_serializable ist in größeren Apps beliebt: Es schreibt den Umwandlungscode für dich in eine .g.dart-Datei. Füge bei diesem Stil json_annotation zu dependencies sowie json_serializable und build_runner zu dev_dependencies hinzu und führe dann dart run build_runner build aus.
Wie werden JSON-Schlüssel in Dart-Feldnamen umgewandelt?
Schlüssel werden in lowerCamelCase umgewandelt, wie von Effective Dart empfohlen, sodass aus first_name firstName wird. Der ursprüngliche Schlüssel wird weiterhin in fromJson und toJson (oder in @JsonKey(name: ...)) verwendet, sodass das JSON unverändert gelesen und geschrieben wird. Reservierte Wörter wie class oder default erhalten einen Unterstrich am Ende.
Was passiert mit Werten, die nur null sind, und gemischten Typen?
Ist ein Wert immer null oder mischt er Typen wie String und Zahl, erhält das Feld den Typ dynamic, weil Dart aus dem Beispiel keinen genaueren Typ ableiten kann. Leere Objekte werden zu Map<String, dynamic>. Ersetze dynamic durch den echten Typ, sobald du ihn kennst.
Wird mein JSON an einen Server gesendet?
Nein. Das JSON wird von JavaScript auf dieser Seite geparst und der Dart-Code dort erzeugt, sodass nichts hochgeladen wird.
Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?
Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.