Konwerter JSON na Dart

Jak JSON staje się modelem Dart z null safety

Oficjalna dokumentacja biblioteki dart:convert wyjaśnia, że jsonDecode() tworzy wartości zgodne z JSON, takie jak liczby, ciągi znaków, wartości logiczne, null, listy i mapy z kluczami tekstowymi. Klasy modelu nie można bezpośrednio zakodować jako JSON, ale jsonEncode() może wywołać jej metodę toJson(). Konwerter generuje taki ręczny schemat serializacji bez adnotacji json_serializable i zależności od dodatkowych pakietów.

Załóżmy, że próbka zawiera użytkownika z zagnieżdżonym adresem. Wygenerowana klasa User ma pola final i konstruktor z nazwanymi parametrami. User.fromJson(Map<String, Object?> json) rzutuje wartości skalarne i wywołuje UserAddress.fromJson() dla zagnieżdżonego obiektu. Jeśli address nie występuje lub ma wartość null w którymkolwiek obiekcie próbki, jego typ zmienia się na UserAddress?, a factory sprawdza wartość przed utworzeniem instancji. Po włączeniu toJson modele zagnieżdżone są rekurencyjnie zamieniane na mapy obsługiwane przez jsonEncode().

Konwerter bada każdy obiekt w tablicy głównej, zamiast opierać się wyłącznie na pierwszym elemencie. Pole staje się nullable, gdy nie występuje w jednym z obiektów albo ma jawną wartość null. Możesz również ustawić wszystkie pola jako nullable, jeśli rzeczywiste API jest mniej przewidywalne niż próbka. Przewodnik Dart po null safety przypomina, że typy domyślnie nie dopuszczają null i wymagają znaku ?, aby ją przyjąć.

Obsługa identyfikatorów i ograniczenia wnioskowania

Klucze JSON nie muszą być poprawnymi składowymi Dart. Znaki interpunkcyjne są usuwane, słowa zamieniane na lowerCamelCase, słowa zastrzeżone otrzymują bezpieczny przyrostek, a kolizje deterministyczne przyrostki liczbowe. Oryginalny klucz pozostaje bez zmian w json['original-key'] i mapie toJson(). Nazwy klas zagnieżdżonych uwzględniają pełną ścieżkę, dzięki czemu niezależne obiekty adresów nie zostaną przypadkowo scalone.

Jedna próbka nie potwierdza całego kontraktu API. Ciągi JSON nie są automatycznie datami, identyfikatorami UUID ani enumami, a pusta tablica nie ujawnia typu elementów. Powtórzone nazwy składowych również nie gwarantują wiernej konwersji w obie strony, ponieważ parsery JSON często zachowują ostatnią wartość. Przed użyciem produkcyjnym porównaj modele z dokumentacją lub schematem API. Limity rozmiaru danych, głębokości, liczby deklaracji i wyniku utrzymują pracę przeglądarki w bezpiecznych granicach.