Tentukan Skema untuk Model

Skema ialah kelas Python yang menyenaraikan medan yang sepatutnya ada pada data anda. Ia mencerminkan model tetapi wujud secara berasingan, khusus untuk input dan output.

Setiap skema mewarisi kelas asas skema daripada Marshmallow. Menamakannya mengikut model, seperti UserSchema, menjadikan tujuannya jelas sekali imbas.

Di dalam kelas, anda menambah atribut daripada modul medan. Setiap satunya menamakan kunci yang akan muncul dalam output JSON bersiri anda.

Pilih jenis medan yang sepadan dengan data: Int, Str, Bool, Float atau DateTime. Jenis itu mengawal cara nilai diformat dan disahkan.

Medan DateTime mensirikan tarikh masa Python menjadi rentetan ISO yang kemas secara automatik. Tiada lagi pemformatan manual yang berselerak dalam paparan anda.

Berikan wajib=True kepada medan supaya pemuatan gagal jika medan itu tiada. Inilah pengenalan pertama anda kepada pengesahan yang terbina terus dalam skema.

Senaraikan hanya medan yang mahu anda dedahkan. Dengan tidak mengisytiharkan password_hash, skema tidak mungkin membocorkannya ke dalam respons.

Mahu JSON camelCase daripada atribut snake_case? Gunakan data_key untuk memetakan nama dalaman kepada kunci luaran yang berbeza.

Sesetengah medan, seperti id, patut muncul dalam output tetapi tidak boleh diterima sebagai input. Tandakan medan itu sebagai dump_only untuk menjadikannya baca sahaja.

Anda mencipta satu tika untuk digunakan semula: user_schema bersamaan UserSchema(). Hantarkan many=True kemudian apabila anda mensirikan keseluruhan senarai.

Kelas tunggal ini akan membuang model ke JSON dan memuatkan JSON kembali menjadi data yang disemak. Anda mentakrifkan bentuk sekali dan menggunakannya dalam kedua-dua arah.

Subkelas skema mengisytiharkan medan berjenis yang dipetakan kepada model anda. Pilihan seperti required, dump_only dan data_key menentukan dengan tepat perkara yang masuk dan keluar.