JSON nedir?

Bir proje listesini web sitesiyle mobil uygulama arasında paylaşacağını düşün. Her projenin başlığı, kategorisi, kapağı ve yayın durumu var. Bunları ekrandaki HTML’den kazımak yerine açık alanlar halinde taşımak istiyorsun. JSON, bu değerleri metin olarak ifade etmek için kullanılabilir. Tasarımı veya iş mantığını taşımaz; farklı tarafların aynı veriyi okuyabileceği bir biçim sunar. Alanların ne anlama geldiğini ise senin sözleşmen belirler.

Örneğin başlık bir metin, yayımlandı alanı bir mantıksal değer, etiketler bir liste olabilir. Fiyatı bir yerde sayı, başka yerde para birimi eklenmiş metin olarak gönderirsen iki taraf aynı alanı farklı yorumlayabilir. Sıfır, boş metin, null ve alanın hiç bulunmaması da aynı şey değildir. Ürün ekranında bu farklar ücretsiz, bilinmiyor, girilmemiş veya uygulanamaz gibi farklı anlamlara dönüşebilir. Biçim geçerli olsa bile veri anlamı yanlış olabilir.

JSON’un JavaScript’e benzemesi bazen yanıltır. JSON metninde yorum veya fonksiyon yazamazsın; anahtarlar ve metin değerleri çift tırnakla ifade edilir. Sonda kalan virgül, sıradan bir nesne yazımında kabul edilse bile JSON ayrıştırmasında sorun çıkarabilir. Bu nedenle örnek dosyayı elle düzenlerken yalnız görünüşüne güvenmeyiz. İçeriği ayrıştırmak bir kontrol, beklenen alanlara ve türlere uyup uymadığını değerlendirmek başka bir kontroldür.

Veri sınırları uygulama tasarımına da yansır. Bir kimlik çok büyük bir tamsayıysa bazı istemcilerde sayı hassasiyeti kaybolabilir; kimliği metin olarak taşıma kararı bu nedenle gerekebilir. Tarih de JSON’da özel bir tarih türü değildir. Tarih metninin biçimini ve saat dilimini ayrıca tanımlamak gerekir. İki sistem aynı dosyayı okuyabiliyor olsa bile aynı anı veya aynı kimliği anladıkları varsayılmamalıdır.

Bir uygulamada JSON çıktısını insanlar da okuyacaksa alan adlarının tutarlılığı bakım maliyetini etkiler. Aynı kavramı bir yanıtta title, başka yanıtta name olarak kullanmak gereksiz çeviri işleri yaratabilir; ancak gerçekten farklı anlamlar taşıyan alanları da sırf benzer göründükleri için birleştirmemek gerekir. Boş dizi ile null arasındaki farkı API sözleşmesinde açıklamak, istemcinin eksik bilgi ile sıfır sonuç durumunu ayırmasını sağlar. Örneğin galeri hiç tanımlanmamış olabilir veya tanımlı ama henüz görsel eklenmemiş olabilir. Bu ayrım arayüzde farklı geri bildirim gerektirebilir. Verinin biçimi kadar bu biçime verilen anlamın da ekip tarafından paylaşılması önemlidir.