JSON Metnini YAML Biçimine Dönüştürme

Ne zaman kullanılır?

Bu araç, elinizdeki geçerli JSON metnini YAML biçimindeki metne çevirmek için kullanılır. Özellikle yapılandırma dosyasını YAML olarak hazırlamak, iç içe nesneleri daha okunabilir bir blok yapısında görmek veya dizilerin YAML listesi olarak nasıl temsil edildiğini kontrol etmek istediğinizde işe yarar. Girdi olarak JSON metni sağlanır; araç nesneler, iç içe nesneler ve diziler içeren geçerli JSON verilerini YAML metnine dönüştürür.

Dönüştürme sırasında girinti düzeyini seçebilir ve eşleme anahtarlarının sıralanmasını isteğe bağlı olarak etkinleştirebilirsiniz. Varsayılan girinti değeri 2'dir; anahtar sıralama tercihi ise varsayılan olarak kapalıdır. YAML çıktısı blok stilindedir. Unicode karakterler korunur, YAML açısından anlam taşıyan bazı metinler tırnak içine alınabilir ve boş olmayan diziler liste işaretleriyle gösterilir. Bu nedenle çıktı, kaynak JSON metninin karakter karakter kopyası değil, YAML kurallarına göre oluşturulmuş yeni bir metindir.

JSON'u YAML'a dönüştürme adımları

JSON metninizi giriş alanına yapıştırın veya yazın. Giriş zorunlu değildir; ancak anlamlı bir YAML çıktısı elde etmek için geçerli bir JSON metni kullanmanız gerekir. Nesne, iç içe nesne ve dizi içeren JSON metinleri desteklenir.
Gerekirse girinti seçeneğini değiştirin. Bir değer belirtmezseniz varsayılan değer olan 2 kullanılır. Daha sonra eşleme anahtarlarının sıralanmasını istiyorsanız ilgili tercihi etkinleştirin; bu tercih başlangıçta devre dışıdır.
Dönüştürme işlemini başlatın. Geçerli girişte sonuç, YAML biçimindeki metin olarak üretilir. Boş ya da yalnızca boşluklardan oluşan giriş de başarılı kabul edilir ve boş YAML metni üretir. Bu özel durumda giriş alanına veri eklemeden işlemi başlatmanız yeterlidir.
Sonuç alanını inceleyin. İç içe yapıların blok düzeninde, dizilerin ise boş olmayan öğeler için liste işaretleriyle gösterilmesini bekleyin. Türkçe karakterler gibi Unicode karakterler korunur. YAML açısından özel anlam taşıyan bir dize tırnak içine alınmışsa bu, çıktının geçerli YAML biçimine uyarlanmasının bir parçasıdır.
İşlem başarısız olursa önce JSON sözdizimini kontrol edin. Geçersiz JSON girişinde YAML metni üretilmez. Giriş geçerliyse fakat YAML serileştirme aşamasında bir hata oluşursa sonuç yine başarısız olarak döner.

Sonuç nasıl yorumlanır?

Başarılı bir sonuç, sağladığınız JSON yapısının YAML karşılığının üretildiğini gösterir. Çıktıyı okurken en dıştaki nesnenin anahtarlarının blok düzeninde yer almasına, iç içe nesnelerin girintiyle ayrılmasına ve boş olmayan dizilerin liste işaretleriyle başlamasına bakın. Anahtar sıralama tercihini açtıysanız eşleme anahtarlarının sıralanmasını bekleyebilirsiniz; bu tercih kapalıyken varsayılan sıralama davranışı kullanılır.

Girinti seçimi, özellikle iç içe verilerde okunabilirliği etkiler. Aynı JSON için farklı girinti değerleri yapının anlamını değiştirmekten çok görünümünü düzenler. Unicode karakterlerin korunması, Türkçe adların veya değerlerin çıktı içinde farklı bir karakter kodlamasına çevrilmeden görünmesini sağlar. YAML açısından özel içeriklerin tırnaklanması da metin değerinin YAML içinde doğru yorumlanmasına yardımcı olan çıktı biçimlendirmesidir.

Boş girişte başarılı işlem ve boş YAML metni beklenir; bu, bir yapılandırma nesnesinin oluşturulduğu anlamına gelmez. Geçersiz JSON durumunda ise sonuç alanında YAML beklenmemelidir. Ayrıca elde edilen metnin, özgün JSON'un tüm biçimlendirme ayrıntılarını koruduğu veya genel amaçlı bir geri dönüşüm garantisi sunduğu varsayılmamalıdır.

Uygulamalı örnek

Bir yapılandırma örneğini YAML olarak incelemek isteyen geliştirici, Türkçe karakter içeren bir ad ve iki öğeli bir liste barındıran JSON metnini dönüştürür.

Giriş alanına {"ad":"ışık","liste":[1,2]} JSON metnini yazın, girinti değerini 2 olarak bırakın ve dönüştürmeyi başlatın.

Sonuç, ad anahtarını ve liste anahtarını blok stilinde gösteren bir YAML metni biçiminde olur; liste değerleri boş olmayan dizi için liste işaretleriyle görünür ve Türkçe karakter korunur.

Sınırlamalar

Araç yalnızca geçerli JSON metni sınırında çalışır. Geçersiz JSON veya YAML serileştirme aşamasındaki bir hata başarılı YAML sonucu üretmez.

Sık yapılan hatalar

Eksik tırnak, kapanmayan süslü parantez ya da hatalı virgül gibi bir JSON sözdizimi hatası dönüşümü başarısız kılar. Girişi geçerli JSON sözdizimine göre düzeltip işlemi yeniden başlatın; geçersiz girişten YAML metni üretilmez.

Sık sorulan sorular

JSON girişi boş bırakılabilir mi?

Evet. Giriş boş veya yalnızca boşluklardan oluşuyorsa işlem başarılı olur ve boş YAML metni üretilir.

Girinti değerini belirtmek zorunlu mu?

Hayır, girinti ayarı zorunlu değildir. Değer belirtmezseniz varsayılan girinti 2 olarak kullanılır.

Diziler YAML çıktısında nasıl görünür?

Geçerli JSON içindeki boş olmayan diziler YAML çıktısında liste işaretleriyle gösterilir; iç içe nesneler de blok stilinde düzenlenir.