Django Academy · Lekcja

Serializery: model do JSON

Konwertowanie obiektów do formatu JSON i z powrotem

Lekcja 2 z 413 kroki

Serializery: model do JSON to bezpłatna lekcja Django Academy na CoddyKit. To lekcja 2 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 Django Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Django Academy zawiera 4 lekcji w sumie.

Warstwa tłumacząca

serializer to tłumacz DRF: konwertuje instancje modeli na JSON do wysłania, a także analizuje przychodzący JSON i przekształca go z powrotem w obiekty Pythona.

Dlaczego nie użyć po prostu json.dumps?

Surowe json.dumps nie obsługuje obiektów modeli ani walidacji. serializer rozumie pola, typy i reguły, dzięki czemu wykonuje za Państwa całą trudną pracę.

Poznajemy ModelSerializer

Najszybszym rozwiązaniem na początek jest ModelSerializer: wystarczy wskazać model, a narzędzie automatycznie wygeneruje odpowiadające mu pola, podobnie jak ModelForm.

from rest_framework import serializers

Deklarowanie serializera

Należy utworzyć podklasę ModelSerializer i użyć wewnętrznej klasy Meta, aby wskazać model oraz pola udostępniane w API.

class BookSerializer(serializers.ModelSerializer):
    class Meta:
        model = Book
        fields = ['id', 'title']

Wybieranie pól

Pola można wymienić jawnie albo użyć fields = '__all__', aby uwzględnić je wszystkie. Jawne wskazanie jest bezpieczniejsze, ponieważ zapobiega przypadkowemu ujawnieniu nowych kolumn.

Serializacja do JSON

Instancję należy przekazać do serializera, a następnie odczytać jego atrybut .data, aby otrzymać gotowy do renderowania słownik Pythona zawierający zwykłe wartości zgodne z JSON.

ser = BookSerializer(book)
ser.data  # {'id': 1, 'title': 'Dune'}

Wiele obiektów naraz

Aby serializować cały queryset, należy dodać many=True. DRF zwróci wtedy listę słowników — po jednym dla każdego obiektu — w jednym kroku.

BookSerializer(books, many=True).data

Deserializacja danych wejściowych

W drugą stronę należy przekazać data= z przychodzącym JSON-em, aby serializer mógł go przeanalizować i później zwalidować dane przesłane przez klienta.

ser = BookSerializer(data=request.data)

Walidowanie danych

Przed zaufaniem danym wejściowym należy wywołać is_valid(). Metoda sprawdza każde pole i wypełnia validated_data albo uzupełnia errors, które można zwrócić.

ser.is_valid()
ser.errors

Bezpieczny zapis

Po pomyślnej walidacji save() tworzy lub aktualizuje instancję modelu, więc serializer obsługuje zarówno tłumaczenie, jak i utrwalanie danych w jednym obiekcie.

ser.save()

Formularze, ale dla API

Serializer można traktować jak form for APIs: renderuje dane wyjściowe, waliduje dane wejściowe i zapisuje je — bez żadnego kodu HTML.

Szybkie sprawdzenie

Co zwraca .data w serializerze modelu?

Podsumowanie: serializery

Dowiedzieli się Państwo, że ModelSerializer konwertuje modele na JSON, waliduje dane wejściowe i zapisuje je, pełniąc funkcję pomostu API. 🔁

Bezpłatny start

Ucz się Python 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

Często zadawane pytania

Czy lekcja „Serializery: model do JSON” jest bezpłatna?

Tak — pełny tekst „Serializery: model do JSON” 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 Django Academy, przejdź na CoddyKit PRO. Kurs Django Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Serializery: model do JSON”?

Konwertowanie obiektów do formatu JSON i z powrotem Ćwiczysz Django 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ąć Django Academy?

Nie wymagamy żadnego doświadczenia. Django 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 2 z 4.

Ile czasu zajmuje lekcja „Serializery: model do JSON”?

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 Django Academy?

Tak. Każda lekcja Django 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

  1. Instalowanie i konfigurowanie DRF
  2. Serializery: model do JSON
  3. APIView i funkcja @api_view
  4. Przeglądalne API i kody statusu
← Powrót do Django Academy