TOML Metnini JSON'a Dönüştürme Rehberi
Geçerli TOML metnini girerek JSON gösterimi oluşturun, ardından girinti düzeyini seçin ve gerekirse anahtar sıralamasını açın. Bozuk TOML, dönüştürülmüş bir JSON gösterimi yerine başarısız bir işlem sonucu verebilir. Girdi boş bırakılırsa sonuç boş bir nesne gösterimidir.
TOML ve JSON arasındaki geçişi anlamak
TOML yapılandırma metnini JSON gösterimine çevirmek, aynı veriyi JSON bekleyen bir uygulamada kullanmanız veya yapının farklı bir gösterimini incelemeniz gerektiğinde işe yarar. Girdi olarak TOML içeriğinin kendisini verirsiniz; sonuç, yapılandırmadaki değerleri ve tabloları JSON karşılığıyla sunar. Metin alanını doldurduktan sonra okunabilirliği artırmak için girinti ayarını değiştirebilir, anahtarların sıralanmasını da tercihinize bırakabilirsiniz. Böylece dönüşüm sonucunu hem veri yapısını kontrol etmek hem de sonraki kullanımınıza uygun bir görünüm elde etmek için inceleyebilirsiniz. Araç; dizeleri, sayıları, doğru/yanlış değerlerini ve iç içe tablo yapılarını karşılık gelen JSON verilerine dönüştürür. Bir tablo altında gruplanan alanlar, sonuçta iç içe JSON nesneleri olarak görünür. Giriş alanını doldurmadan da davranışı görebilirsiniz: boş ya da yalnızca boşluk içeren içerik başarılı biçimde boş bir JSON nesnesi gösterir. Bu özel durum, dönüşüm için henüz metin hazırlamadığınızda sonucu anlamanıza yardımcı olur. Dönüştürülecek içerik sunulduğunda ise yapının geçerli TOML biçiminde olması gerekir.
Dönüşümü çalıştırma sırası
- Dönüştürmek istediğiniz TOML metnini giriş alanına yapıştırın. Düz bir değer içeren kısa bir içerik kullanabileceğiniz gibi, tablo başlıkları altında gruplanmış ve birbirinin içinde yer alan yapıları da ekleyebilirsiniz. 2. JSON gösterimi için kullanılacak girinti sayısını belirleyin. Bir seçim yapmazsanız varsayılan girinti değeri 2 olarak kullanılır. Girinti, verilerin ilişkisini değiştirmez; yalnızca sonuçtaki satır ve boşluk düzenini daha rahat okunacak şekilde sunar. 3. Sonuçtaki anahtarların sıralanmasını istiyorsanız ilgili seçeneği etkinleştirin. Bu seçenek başlangıçta kapalıdır, dolayısıyla anahtar sıralaması istemediğiniz durumda ayrıca bir işlem yapmanız gerekmez. 4. Dönüştürmeyi başlatın ve oluşturulan JSON gösterimini gözden geçirin. Üst düzey alanların, tablo başlıklarının ve bunların altındaki değerlerin beklediğiniz hiyerarşiyi oluşturup oluşturmadığını kontrol edin. 5. İşlem başarısız görünürse önce TOML yazımını inceleyin. Eksik ayraç, hatalı tablo tanımı veya geçersiz bir değer bulursanız içeriği düzelttikten sonra yeniden çalıştırın. Metin hazırlamadan deneme yapmak istediğinizde alanı boş bırakabilirsiniz; boş veya yalnızca boşluk içeren giriş hata sayılmaz ve boş nesne gösterimiyle tamamlanır.
JSON görünümündeki anlamı değerlendirmek
Başarılı sonuç, verdiğiniz TOML yapısının JSON karşılığını gösterir. Metinler, sayılar ve doğru/yanlış değerleri JSON içinde ilgili değer türleriyle sunulur; bir tablo başlığı altında toplanan alanlar ise iç içe nesne görünümü kazanır. Bu nedenle sonucu değerlendirirken yalnızca tek tek değerleri değil, üst düzey alanlarla alt tablolar arasındaki ilişkiyi de kontrol edin. Girinti tercihi veri içeriğini değiştirmez, yalnızca gösterimdeki düzeni etkiler. Anahtar sıralama seçeneği açık olduğunda sonuçtaki anahtarların sunuluş düzeni değişebilir; bu ayar da değerlerin kendisini dönüştürmez. TOML tarih, saat ve tarih-saat değerleri JSON sonucunda ISO biçimli dizeler olarak serileştirilir. Bunları JSON'a özgü tarih türleri yerine metin değerleri olarak ele almanız gerekir. Boş girdinin başarılı sonucu, içerik taşımayan boş bir JSON nesnesi gösterimidir. Buna karşılık biçimi bozuk TOML için dönüştürülmüş bir JSON sonucu beklemeyin. TOML geçerli görünse bile JSON serileştirmesi sırasında bir hata oluşması işlemi başarısız kılabilir; böyle bir durumda girdiyi ve sorun çıkarabilecek değerleri ayrı ayrı inceleyin.
Uygulamalı örnek
Bir yapılandırma metninde [uygulama] tablosu altında port = 8080 bulunuyor ve bu içeriği JSON gösterimine çevirmek istiyorsunuz.
[uygulama] ve port = 8080 içeren metni giriş alanına ekleyip varsayılan ayarlarla dönüşümü başlatın. Sonuçta uygulama başlığının iç içe nesneye, port değerinin ise sayısal alana karşılık geldiğini kontrol edin; bu kontrol yapının nasıl eşlendiğini gösterir ve başka ayar gerektirmez.
Sonuçta üst düzey bir JSON nesnesi, bu nesne içinde uygulamayı temsil eden iç içe bir nesne ve onun altında JSON sayısı olarak görünen bir port alanı bulunur. Girinti tercihi, bu alanların gösterimdeki düzenini belirler.
Sınırlamalar
- Bozuk TOML dönüştürülmüş sonuç oluşturmaz; JSON serileştirmesi sırasında yaşanan bir hata da işlemin başarısız olmasına neden olabilir.
Sık yapılan hatalar
- Eksik ayraç veya hatalı tablo tanımı içeren TOML dönüşümün başarısız olmasına yol açabilir; ilgili satırı geçerli TOML sözdizimine göre düzeltip işlemi yeniden başlatın.
Sık sorulan sorular
TOML girişi boş bırakılabilir mi?
Giriş alanı boş veya yalnızca boşluk içeriyorsa işlem başarılı olur ve sonuçta boş bir JSON nesnesi gösterimi yer alır. İçerik dönüştürmek istediğinizde bunun yerine TOML metnini eklemeniz gerekir; boş sonuç bir hata bildirimi değildir.
JSON gösteriminin biçimi değiştirilebilir mi?
Girinti ayarını değiştirebilir ve anahtar sıralama seçeneğini açabilirsiniz. Varsayılan girinti değeri 2'dir; sıralama tercihi belirtilmediğinde anahtar sıralaması etkin değildir. Bu kontroller, verinin değerlerini değil JSON görünümünün düzenini etkiler.
Geçersiz TOML otomatik olarak düzeltilir mi?
TOML biçimi geçerli değilse işlem başarılı bir JSON dönüşümü üretmez. Sözdizimini kontrol edip hatalı tablo veya değer tanımlarını düzelttikten sonra aynı içeriği yeniden çalıştırın; araç bozuk metni otomatik olarak onarmaz.