XML Metni Nasıl Biçimlendirilir ve Küçültülür?

XML görünümünü seçmeden önce bilinmesi gerekenler

XML metniyle çalışırken iki farklı görünüm ihtiyacı ortaya çıkabilir. Hiyerarşiyi incelemek, öğeleri düzenlemek veya bir hatanın hangi bölümde bulunduğunu araştırmak için girintili çıktı daha elverişlidir. Daha sıkı bir metin gerektiğinde ise küçültme modu kullanılabilir. XML Formatter, XML metnini okunabilir ve girintili bir biçime dönüştürür; ayrıca küçültme seçeneği sunar.

Girintili görünüm, iç içe öğeleri satırlara ve boşluk düzeylerine ayırarak yapıyı gözle takip etmeyi kolaylaştırır. Varsayılan girinti genişliği iki boşluktur ve bu genişlik değiştirilebilir. Küçültme işlemi yorumları kaldırır, etiketler arasındaki boşlukları daraltır ve metnin başındaki ve sonundaki boşlukları temizler. Bu nedenle iki modun amacı aynı değildir: biri inceleme ve düzenleme kolaylığına, diğeri daha sıkı bir XML gösterimine odaklanır.

İşlem, içeriği XML olarak ele alır. İçerik bulunan bir girişin ayrıştırılması gerektiği için kapanmayan etiketler, yanlış iç içe geçirme veya başka bir XML sözdizimi sorunu biçimlendirilmiş çıktı yerine başarısız bir sonuçla karşılaşmanıza neden olabilir. Boş ya da yalnızca boşluk içeren giriş bu kuralın dışındadır ve başarılı biçimde boş çıktı üretir.

XML metnini biçimlendirme ve küçültme adımları

XML içeriğini giriş alanına metin olarak ekleyin. Girdi, işlenebilmesi için XML metni olmalıdır; metin yerine başka bir türde değer verilmesi başarısız sonuç doğurur. Yalnızca boşluklardan oluşan bir içerik kullanıyorsanız araç bunu özel bir durum olarak ele alır ve boş çıktı verir.
Okunabilir bir düzen istiyorsanız varsayılan biçimlendirme seçeneğini kullanın. Girinti genişliğini ihtiyacınıza göre belirleyin; iki boşluk başlangıç değeridir. İçeriği bulunan bir girişte sıfırdan küçük, sekizden büyük veya tam sayıya dönüştürülemeyen bir genişlik kullanılırsa araç iki boşluklu değere geri döner. Böylece geçersiz bir genişlik seçimi, beklenmeyen bir girinti ölçüsüyle sonuçlanmaz.
Daha sıkı bir XML görünümü gerekiyorsa küçültme modunu seçin. Bu seçim, içerik bulunan girişlerde XML doğrulamasından sonra uygulanır. XML ayrıştırılamazsa küçültülmüş çıktı beklemek yerine başarısız sonuçla karşılaşabilirsiniz. Yorumların korunması veya etiketler arasındaki görsel boşlukların aynı kalması gerekiyorsa küçültme yerine girintili biçimi tercih edin.
Biçimlendirme işlemini başlatın ve oluşan metni seçtiğiniz amaca göre kontrol edin. Girintili işlemde XML önce ayrıştırılır, sonra okunabilir bir düzen oluşturulur. Küçültme işleminde yorumlar, etiketler arasındaki boşluk ve metnin iki ucundaki gereksiz boşluklar çıktıdan çıkarılır. Bu davranış, içerikteki yorumların ya da görsel satır düzeninin korunması gereken durumlarda özellikle önemlidir.
İşlem başarısız olursa önce girişin metin olarak verildiğini değerlendirin. Ardından her açılış etiketinin uygun kapanışı bulunduğunu, öğelerin doğru sırada iç içe yerleştiğini ve XML yapısının ayrıştırılabilir olduğunu kontrol edin. Sorun yalnızca biçimlendirme seçeneğinden kaynaklanmayabilir; geçersiz XML, girintili işlemde de küçültme işleminde de başarısız sonuca yol açabilir.
Büyük içerikleri gönderirken boşluk dışındaki verinin boyutunu hesaba katın. İçerik bulunan girişler için UTF-8 biçimindeki boyut 1.000.000 baytı aşarsa giriş reddedilebilir. Buna karşılık boş veya yalnızca boşluk içeren metin, bu boyut kontrolünden önce boş çıktı olarak işlenir. Bu ayrım, büyük bir XML belgesini incelerken sonucun neden alınamadığını araştırmanıza yardımcı olur.
Son metni kullanım amacınıza göre alın. Bir belgeyi okumak, düzenlemek veya öğe ilişkilerini kontrol etmek için girintili sonucu kullanın. Yalnızca daha sıkı bir gösterim istediğinizde küçültülmüş sonucu seçin ve bu modun yorumları ile etiketler arasındaki boşlukları korumadığını göz önünde bulundurun.

Oluşan çıktıyı ve başarısız sonucu okuma

Girintili sonuçta satırların ve boşluk düzeylerinin XML hiyerarşisini yansıttığını görebilirsiniz. Bir öğenin başka bir öğe içindeki konumu, seçtiğiniz girinti genişliğine göre farklı bir yatay uzaklıkla gösterilir. Bu görünüm XML'in yapısını daha rahat incelemenizi sağlar, ancak geçersiz bir yapıyı kendiliğinden onarmaz.

Küçültülmüş sonuç daha sıkı bir metin biçimindedir. Yorumların görünmemesi ve etiketler arasındaki boşluğun daralması bu modun beklenen sonucudur; bu nedenle kaynak metinle çıktı arasında görsel boşluk veya yorum farkı bulunabilir. Çıktıyı karşılaştırırken yalnızca satır sayısına bakmak yerine XML yapısının ve içerik öğelerinin amacınıza uygun kaldığını da inceleyin.

Başarısız sonuç, içerik bulunan metnin ayrıştırma veya giriş koşullarını karşılamadığını gösterebilir. Etiket eşleşmelerini, iç içe geçirme sırasını, girişin metin niteliğini ve 1.000.000 UTF-8 bayt sınırını ayrı ayrı denetleyin. Boş girişte ise hata aramak yerine başarılı boş çıktı alınmasının beklenen davranış olduğunu hatırlayın.

Uygulamalı örnek

Bir geliştirici, tek satırda bulunan katalog XML'inin öğe hiyerarşisini düzenleme öncesinde incelemek ister.

Bir geliştirici <catalog><item id="1">Kitap</item></catalog> metnini giriş alanına yapıştırır ve iki boşluklu varsayılan biçimlendirmeyi çalıştırır.

İşlem sonrasında öğeler ayrı satırlarda görünür ve iç içe düzeyler seçilen iki boşlukla girintilenir; küçültme seçilirse yorumlar ile etiketler arasındaki boşluklar sonuçta bulunmaz.

Sınırlamalar

İçerik bulunan giriş metin türünde olmalı, ayrıştırılabilir XML yapısı taşımalı ve UTF-8 olarak 1.000.000 baytı aşmamalıdır; bu koşullar sağlanmazsa giriş reddedilebilir veya işlem başarısız olabilir.

Sık yapılan hatalar

Kapanış etiketi eksik veya öğeler yanlış sırada iç içe yerleştirilmişse ayrıştırma başarısız olabilir; etiket çiftlerini ve hiyerarşiyi düzelterek XML metnini yeniden gönderin.

Sık sorulan sorular

Boş XML girdisi işlenir mi?

Yalnızca boşluk veya hiç içerik bulunmayan giriş kabul edilir ve başarılı biçimde boş çıktı üretir. İçeriği bulunan bir metin için XML ayrıştırma koşulları geçerlidir.

Girinti genişliğini değiştirebilir miyim?

İçerik bulunan girişte iki boşluk varsayılan girinti genişliğidir. Sıfırın altındaki, sekizden büyük veya tam sayıya çevrilemeyen değerler yerine iki boşluk kullanılır.

Küçültme modu XML yorumlarını korur mu?

Hayır, küçültme seçildiğinde XML yorumları, etiketler arasındaki boşluk ve metnin başındaki veya sonundaki boşluklar korunmaz. Yorum ya da görsel boşluk düzeni gerekli olduğunda girintili görünümü seçin.