JSON Lines mı JSON dizisi mi: dışa aktarımı düzeltmeden önce tanı

İlk iki tam kaydı oku

Günlük dışa aktarımı her satırda tamamlanmış bir nesne içerebilir. Dosyanın tamamını tek JSON belgesi bekleyen biçimlendiriciye yapıştırınca, her satır tek başına geçerli olsa da ilk nesneden sonra hata alınabilir. Bu, biçim uyuşmazlığının işaretidir; dışa aktaran uygulamanın noktalama kaybettiğini tek başına kanıtlamaz.

JSON Lines düzeni UTF-8 kullanır ve her satırda geçerli bir JSON değeri tutar. Boş satır değer değildir; son kayıttan sonra satır sonu bulunabilir. JSON dizisinde ise dışta köşeli ayraçlar, öğeler arasında virgüller vardır. Dosya uzantısını ipucu olarak kullan; kararı içerik ve üreten uygulamanın belgesiyle ver.

JSON Lines:
{"event":"opened","item":"R-7"}
{"event":"saved","item":"R-7"}

Tek JSON dizisi:
[{"event":"opened","item":"R-7"},{"event":"saved","item":"R-7"}]

JSON Lines format documentation ↗RFC 8259: JSON grammar ↗

Değer ile görüntüleme satırını ayır

İki olaylı örnekte her nesne tek fiziksel satırda durur. Metin içindeki kaçış dizisi \n yeni fiziksel kayıt oluşturmaz. Buna karşılık tek nesneyi girintileyip fiziksel olarak birkaç satıra yaymak, JSON Lines okuyucusunun beklediği satır başına tek değer düzenini bozar.

Rastgele bir JSON dizisinin değer sayısını satır sayacıyla bulma. Dizi tek satırda da çok satırda da yazılabilir. JSON Lines dosyasında bütün kayıtları kontrol ettikten sonra başarıyla ayrıştırılan değerleri say. Ham satır sayısı hatalı nesneyi veya ortadaki boş satırı tespit edemez.

Tek fiziksel JSON Lines kaydı:
{"note":"first line\nsecond line"}

Ayrıştırıldığında note değeri kendi içinde satır sonu içerir.

Değeri ortasından kesmeden küçük örnek hazırla

Asıl dışa aktarımı sakla. Özel veri içermeyen iki tam kaydı çalışma dosyasına al ve beklenen değer sayısını yaz. KitForma JSON Biçimlendirici ile her JSON Lines kaydını ayrı inceleyebilir veya dizinin tamamını açabilirsin. Araç akış halinde JSON Lines içe aktarmaz; art arda nesnelere otomatik dış ayraç eklemez.

Alıcı yalnız dizi kabul ediyorsa her satırı ayrıştıran ve tek dizi yazan bir dönüşüm kullan. Değer türlerini, Unicode metni ve sayı hassasiyetini kontrol et. Bütün satır sonlarını körlemesine virgüle çevirmek metni bozabilir veya boş öğe oluşturabilir. Büyük dosyada boyuta uygun, belleği sınırlayan ya da akışla çalışan çözüm gerekir.

1. Üreten uygulamadan dışa aktarma biçimini doğrula.
2. Özel veri içermeyen iki tam kayıt seç.
3. Her kaydı doğrula ve beklenen sayıyı not et.
4. Alıcının belgesindeki biçimle örneği içe aktar.
5. Tam dosyadan önce kaydedilen değerleri karşılaştır.

Teslim bilgisini açık yaz

Teslim notunda kodlamayı, kapsayıcı biçimini, kayıt sayısını ve son satırın satır sonu içerip içermediğini belirt. Dönüşüm yapan betik veya aracın sürümünü ekle. Alıcı beklenen kayıtları doğrulayana kadar kaynak ve çıktıyı birlikte sakla.

Söz dizimi doğru olan dönüşüm yine de anlam kaybedebilir. Olay sırası önemliyse ilk ve son olay kimliğini, ayrıca ortadan bir kaydı karşılaştır. Uzun sayısal kimlikler varsa kolaylık için sayıya çevirmek yerine belgelenmiş gösterimini koru.

Soru: Dosyanın başına ve sonuna köşeli ayraç eklemek yeterli mi?

Tek başına yetmez. Değerlerin arasında ayırıcılar bulunmalı ve her kaynak satır önce geçerli kayıt olmalıdır. Seçilen biçime uygun ayrıştırıcı ve yazıcı kullan; ardından kayıt sayısını ve örnek değerleri karşılaştır.

Soru: Yalnız null yazan satır boş kayıt mı?

JSON Lines düzeninde bu geçerli bir JSON değeridir; boş fiziksel satırdan farklıdır. İçe aktarıcı her değerin nesne olmasını isteyebilir. Bu ek koşulu ayrıca kontrol et.