Tentukan Skema untuk Model

Schema adalah kelas Python yang mencantumkan bidang yang harus dimiliki data Anda. Skema ini mencerminkan model, tetapi berada terpisah dan khusus untuk masukan serta keluaran.

Setiap skema mewarisi kelas dasar Schema dari Marshmallow. Menamainya berdasarkan model, seperti UserSchema, membuat maksudnya langsung jelas.

Di dalam kelas, Anda menambahkan atribut dari modul bidang. Masing-masing menamai kunci yang akan muncul dalam keluaran JSON yang diserialisasi.

Pilih tipe bidang yang sesuai dengan data: Int, Str, Bool, Float, atau DateTime. Tipe tersebut mengatur cara nilai diformat dan divalidasi.

Bidang DateTime otomatis menserialisasi datetime Python menjadi string ISO yang rapi. Tidak ada lagi pemformatan manual yang tersebar di berbagai tampilan.

Berikan required=True pada bidang agar proses pemuatan gagal jika bidang tersebut tidak ada. Inilah pengenalan pertama Anda terhadap validasi yang tertanam langsung dalam skema.

Cantumkan hanya bidang yang ingin Anda tampilkan. Dengan tidak mendeklarasikan password_hash, skema tidak akan pernah membocorkannya ke dalam respons.

Ingin JSON camelCase dari atribut snake_case? Gunakan data_key untuk memetakan nama internal ke kunci eksternal yang berbeda.

Beberapa bidang, seperti id, seharusnya muncul dalam keluaran tetapi tidak pernah diterima sebagai masukan. Tandai sebagai dump_only agar tetap hanya dapat dibaca.

Buat satu instans untuk digunakan kembali: user_schema sama dengan UserSchema(). Berikan many=True nanti saat Anda menserialisasi seluruh daftar.

Kelas tunggal ini akan membuang model ke JSON sekaligus memuat JSON kembali menjadi data yang telah diperiksa. Anda mendefinisikan bentuk sekali dan menggunakannya untuk kedua arah.

Subkelas Schema mendeklarasikan bidang bertipe yang dipetakan ke model Anda. Opsi seperti required, dump_only, dan data_key menentukan dengan tepat apa yang masuk dan keluar.