Bir Model için Şema Tanımlama

Bir şema, verilerinizin sahip olması gereken alanları listeleyen bir Python sınıfıdır. Bir modeli yansıtır, ancak yalnızca giriş ve çıkış için ayrı olarak bulunur.

Her şema, Marshmallow'un temel şema sınıfından miras alır. UserSchema gibi modelinizin adını kullanmak, amacı ilk bakışta açıkça gösterir.

Sınıfın içinde alanlar modülündeki öznitelikleri eklersiniz. Her biri, serileştirilmiş JSON çıktınızda görünecek bir anahtarı adlandırır.

Veriyle eşleşen bir alan türü seçin: Int, Str, Bool, Float veya DateTime. Tür, değerlerin nasıl biçimlendirileceğini ve doğrulanacağını belirler.

Bir DateTime alanı, Python tarih-saat değerlerini otomatik olarak düzenli ISO dizelerine serileştirir. Görünümlerinize dağılmış elle biçimlendirme kodlarına artık gerek kalmaz.

Bir alanın eksik olması durumunda yükleme işleminin başarısız olması için alana required=True geçirin. Bu, doğrulamanın doğrudan şemaya yerleştirilmesine ilk örneğinizdir.

Yalnızca açığa çıkarmak istediğiniz alanları listeleyin. password_hash alanını tanımlamayarak şemanın bunu bir yanıta sızdırmasını önlersiniz.

snake_case özniteliğinden camelCase JSON mu istiyorsunuz? Dahili bir adı farklı bir dış anahtara eşlemek için data_key kullanın.

Kimlik gibi bazı alanlar çıktıda görünmeli, ancak giriş olarak hiçbir zaman kabul edilmemelidir. Salt okunur kalmaları için onları dump_only olarak işaretleyin.

Yeniden kullanmak üzere bir örnek oluşturursunuz: user_schema, UserSchema() değerine eşittir. Daha sonra bir listenin tamamını serileştirirken many=True geçirin.

Bu tek sınıf hem modelleri JSON'a dökecek hem de JSON'u denetlenmiş verilere geri yükleyecektir. Yapıyı bir kez tanımlar ve her iki yönde kullanırsınız.

Bir şema alt sınıfı, modelinize eşlenen tür belirli alanları tanımlar. required, dump_only ve data_key gibi seçenekler, içeri giren ve çıkan verilerin yapısını tam olarak belirler.