JSON-naar-Dart-converter

Zo wordt JSON een null-safe Dart-model

De officiële documentatie voor dart:convert legt uit dat jsonDecode() JSON-compatibele waarden oplevert, zoals getallen, tekenreeksen, booleans, null, lijsten en maps met tekenreeksen als sleutel. Een modelklasse kan niet rechtstreeks als JSON worden gecodeerd, maar jsonEncode() kan de methode toJson() aanroepen. Deze converter genereert dat handmatige serialisatiepatroon zonder json_serializable-annotaties of pakketafhankelijkheden.

Stel dat een voorbeeld een gebruiker met een genest adres bevat. De gegenereerde klasse User heeft final-velden en een constructor met benoemde parameters. User.fromJson(Map<String, Object?> json) cast scalaire waarden en roept UserAddress.fromJson() aan voor het geneste object. Als address in een van de onderzochte objecten ontbreekt of null is, wordt het type UserAddress? en controleert de factory de waarde voordat het object wordt gemaakt. Als toJson is ingeschakeld, worden geneste modellen recursief omgezet in maps die jsonEncode() accepteert.

De converter onderzoekt elk object in een hoofdarray en vertrouwt niet alleen op het eerste item. Een veld wordt nullable wanneer het in één item ontbreekt of expliciet null is. Je kunt ook alle velden nullable maken wanneer de echte API minder voorspelbaar is dan het voorbeeld. De Dart-handleiding voor null safety vermeldt dat typen standaard niet nullable zijn en ? nodig hebben om null te accepteren.

Identifiers en grenzen van de type-inferentie

JSON-sleutels hoeven geen geldige Dart-members te zijn. Leestekens worden verwijderd, woorden worden omgezet naar lowerCamelCase, gereserveerde woorden krijgen een veilige suffix en botsingen krijgen deterministische numerieke suffixen. De oorspronkelijke sleutel blijft ongewijzigd in json['original-key'] en in de map van toJson(). Namen van geneste klassen gebruiken het volledige pad, zodat twee losstaande adresobjecten niet onbedoeld één klasse worden.

Eén voorbeeld bewijst geen API-contract. JSON-tekenreeksen zijn niet automatisch datums, UUID’s of enums en een lege array geeft geen elementtype prijs. Dubbele membernamen zijn evenmin betrouwbaar heen en terug te converteren, omdat JSON-parsers vaak de laatste waarde behouden. Vergelijk de gegenereerde modellen vóór productiegebruik met de API-documentatie of het schema. Limieten voor invoer, diepte, afgeleide declaraties en uitvoer houden het werk in de browser beheersbaar.