Elle Oluşturulmuş JSON Neden Dağılır

Başlangıçta JSON'u elle oluşturur, modelinizdeki her alanı bir sözlüğe kopyalarsınız. Basit görünür ve tek bir uç nokta için gerçekten de öyledir.

Birkaç sütun eklediğinizde sözlüğünüz satır satır büyür. Kısa süre sonra tek bir model, eşzamanlı tutmanız gereken uzun ve kırılgan bir anahtar-değer çiftleri bloğu anlamına gelir.

Liste ve ayrıntı uç noktaları aynı sözlüğü yeniden oluşturur. Bu tekrarlama, tek bir yeniden adlandırmanın aynı yapıyı birçok yerde düzenlemenizi gerektirmesi demektir.

Ham bir tarih-saat değeri JSON için uygun değildir; bu nedenle jsonify hata verir veya tahminde bulunur. Elle yazılan kod, uygulamanızdaki tarihleri iki farklı yerde nadiren aynı biçimde düzenler.

Bir modelin tamamını döktüğünüzde password_hash veya dahili bayrakları da gönderebilirsiniz. Elle oluşturulan JSON, özel alanları açığa çıkarmayı fazlasıyla kolaylaştırır.

Birçok gönderisi olan tek bir kullanıcı, listelerin içindeki sözlüklerin içinde döngüler anlamına gelir. Nested yapılar, seri hale getirme kodunuzu kimsenin okumaktan hoşlanmayacağı bir karmaşaya dönüştürür.

Elle oluşturulan JSON yalnızca çıktıyı düşünür. Gelen yükler hâlâ denetlenmeden gelir; bu nedenle doğrulama, elle yazdığınız başka bir if ifadeleri yığınına dönüşür.

Bir şema, verilerinizi tek seferde tanımlar: hangi alanların bulunduğunu, türlerini ve kurallarını belirtir. Böylece hem çıktı hem de giriş bu tek tanımdan geçer.

Marshmallow, Flask'te bunun için kullanılan popüler kütüphanedir. Bir şema sınıfı tanımlarsınız; kütüphane dışarıya serileştirme ve içeriye doğrulama işlemlerini yönetir.

Bir şemayla alan listesi tek bir yerde bulunur. Bir alanı orada yeniden adlandırır veya kaldırırsanız tüm uç noktalar otomatik olarak tutarlı kalır.

Onlarca kırılgan sözlük satırı yerine düzenli bir sınıf kullanırsınız. Sonuç; daha az kod, daha güvenli çıktı ve API'niz için açık bir sözleşmedir.

Bir şema katmanı en iyi hangi sorunu çözer?

Elle oluşturulan JSON, işleri tekrarlar, tarihleri yanlış işler ve gizli bilgileri sızdırır. Marshmallow gibi bir şema katmanı, temiz ve güvenli bir çıktı için veri yapınızı merkezileştirir.