Dart Academy · Lekcja

json_serializable w praktyce

Automatyczne generowanie serializacji modeli

Lekcja 4 z 413 kroki

json_serializable w praktyce to bezpłatna lekcja Dart Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Dart Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Dart Academy zawiera 4 lekcji w sumie.

Problem z kodem szablonowym JSON

Ręczne pisanie fromJson i toJson jest żmudne i podatne na błędy. Pakiet json_serializable generuje obie te funkcje na podstawie modelu. 📦

Dodawanie pakietów

Potrzebuje Pan/Pani json_annotation jako zwykłej zależności, a json_serializable i build_runner jako zależności deweloperskich do generowania kodu.

dependencies:
  json_annotation: ^4.9.0

Dodawanie adnotacji do klasy

Model należy oznaczyć adnotacją @JsonSerializable. Informuje ona generator, że ma utworzyć kod serializacji dla tej klasy.

@JsonSerializable()
class User {
  final String name;
  User(this.name);
}

Deklarowanie pliku części

Należy dodać dyrektywę part, aby plik mógł zawierać wygenerowane funkcje pomocnicze. Jego nazwa odpowiada nazwie pliku i ma przyrostek .g.dart.

part 'user.g.dart';

Podłączanie fromJson

Należy dodać fabrykę, która przekazuje wywołanie do wygenerowanej funkcji. Funkcja pomocnicza _$UserFromJson jest tworzona przez builder.

factory User.fromJson(Map<String, dynamic> j) =>
    _$UserFromJson(j);

Podłączanie toJson

Należy dodać metodę wywołującą wygenerowany zapis. Funkcja pomocnicza _$UserToJson przekształca obiekt z powrotem w mapę JSON.

Map<String, dynamic> toJson() => _$UserToJson(this);

Generowanie kodu

Po jednorazowym uruchomieniu build_runner pojawi się plik user.g.dart z dwiema w pełni zaimplementowanymi funkcjami pomocniczymi, gotowymi do użycia.

dart run build_runner build

Zmiana nazwy klucza JSON

Gdy nazwa pola w API różni się od nazwy w Dart, należy użyć @JsonKey, aby je zmapować. Kod pozostaje przejrzysty, a JSON jest zgodny z serwerem.

@JsonKey(name: 'full_name')
final String fullName;

Podawanie wartości domyślnej

Można podać wartość zastępczą dla brakujących pól. Opcja defaultValue wstawia tę wartość, gdy klucza brakuje w JSON-ie.

@JsonKey(defaultValue: 0)
final int score;

Zagnieżdżone modele działają automatycznie

Jeśli pole jest inną klasą oznaczoną adnotacją @JsonSerializable, generator serializuje je rekurencyjnie. Zagnieżdżone obiekty nie wymagają dodatkowej pracy.

Używanie jak zwykłego kodu Dart

Po wygenerowaniu kodu analizowanie i kodowanie odbywa się za pomocą zwykłych wywołań metod. Wygenerowane helpers pozostają ukryte, więc miejsca ich wywołania wyglądają naturalnie.

final u = User.fromJson(data);
final back = u.toJson();

Szybkie sprawdzenie

Która adnotacja oznacza klasę do generowania kodu JSON?

Odpowiedz w interaktywnej lekcji

Podsumowanie

Należy dodać adnotację @JsonSerializable, podłączyć fromJson i toJson, a następnie uruchomić build_runner. Za pomocą @JsonKey można mapować nazwy pól i wartości domyślne. 🎉

Bezpłatny start

Ucz się Dart dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy: 30
Lekcje: 120

Zacznij naukę bezpłatnie Wyświetl pełny kurs

Często zadawane pytania

Czy lekcja „json_serializable w praktyce” jest bezpłatna?

Tak — pełny tekst „json_serializable w praktyce” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Dart Academy, przejdź na CoddyKit PRO. Kurs Dart Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „json_serializable w praktyce”?

Automatyczne generowanie serializacji modeli Ćwiczysz Dart Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Dart Academy?

Nie wymagamy żadnego doświadczenia. Dart Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.

Ile czasu zajmuje lekcja „json_serializable w praktyce”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Dart Academy?

Tak. Każda lekcja Dart Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

Wbudowane adnotacje: override, deprecated
Pisanie własnych adnotacji
Generowanie kodu za pomocą build_runner
json_serializable w praktyce

← Powrót do Dart Academy