XML Biçimlendirici

XML Biçimlendirici Nedir ve Neden Kullanılır?

<!-- Minified XML input -->
<?xml version="1.0" encoding="UTF-8"?><catalog><product id="p01"><name>Wireless Headphones</name><price currency="USD">79.99</price></product></catalog>

<!-- After formatting with 2-space indent -->
<?xml version="1.0" encoding="UTF-8"?>
<catalog>
  <product id="p01">
    <name>Wireless Headphones</name>
    <price currency="USD">79.99</price>
  </product>
</catalog>

Temel Özellikler

Örnekler

<?xml version="1.0" encoding="UTF-8"?><catalog><product id="p01" category="electronics"><name>Wireless Headphones</name><price currency="USD">79.99</price><stock>142</stock><tags><tag>audio</tag><tag>bluetooth</tag></tags></product><product id="p02" category="books"><name>Learning XML</name><price currency="USD">29.99</price><stock>55</stock></product></catalog>

<rss version="2.0"><channel><title>Go Tools Blog</title><link>https://go-tools.org/blog</link><description>Developer tools, tips and tutorials</description><item><title>Understanding XML Namespaces</title><link>https://go-tools.org/blog/xml-namespaces-guide</link><pubDate>Thu, 29 May 2026 00:00:00 GMT</pubDate><description>A deep dive into XML namespace declarations, prefixes, and scope rules with practical examples.</description></item><item><title>XML vs JSON: When to Use Each</title><link>https://go-tools.org/blog/xml-vs-json</link><pubDate>Mon, 25 May 2026 00:00:00 GMT</pubDate></item></channel></rss>

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><soap:Header><wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><wsse:UsernameToken><wsse:Username>api-client</wsse:Username><wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-ext-1.0.xsd#PasswordText">s3cr3t</wsse:Password></wsse:UsernameToken></wsse:Security></soap:Header><soap:Body><GetOrderRequest xmlns="http://example.com/orders"><OrderId>ORD-20260529-001</OrderId><IncludeLineItems>true</IncludeLineItems></GetOrderRequest></soap:Body></soap:Envelope>

Nasıl Kullanılır

1. 1

   XML'inizi Yapıştırın

   XML'inizi yukarıdaki giriş alanına girin veya yapıştırın. Bir örnek denemek için 'Örnek yükle' düğmesine de tıklayabilirsiniz (güzelce biçimlenen küçültülmüş bir ürün kataloğu XML).

2. 2

   Bir Eylem Seçin

   Girintiyle güzelleştirmek için Biçimlendir'e, boşlukları temizlemek için Küçült'e veya iyi biçimliliği kontrol etmek için Doğrula'ya tıklayın. Biçimlendirmeden önce 2 veya 4 boşluk girinti boyutu seçin.

3. 3

   Çıktıyı Kopyalayın

   İşlenmiş XML çıktı panelinde görünür. Panoya almak için Kopyala'ya tıklayın. Doğrula hata bulduysa hata başlığı tam satır ve sütun numarasını gösterir.

Yaygın XML Hataları

<products>
  <Item>
    <name>Widget</name>
  </item>
</products>

<products>
  <item>
    <name>Widget</name>
  </item>
</products>

<query>price > 10 & stock > 0</query>

<query>price &gt; 10 &amp; stock &gt; 0</query>

<product id=p01 label="It's a "widget"">

<product id="p01" label="It's a &quot;widget&quot;">

<user><name>Alice</name></user>
<user><name>Bob</name></user>

<users>
  <user><name>Alice</name></user>
  <user><name>Bob</name></user>
</users>

<?xml version="1.0" encoding="UTF-8"?>
<!-- File is actually saved as UTF-16 -->

<?xml version="1.0" encoding="UTF-16"?>
<!-- File saved as UTF-16, declaration matches -->

<script><![CDATA[
  if (a < b && b > c) { return true; }
<!-- ]]> is missing -->

<script><![CDATA[
  if (a < b && b > c) { return true; }
]]></script>

Yaygın Kullanım Senaryoları

SOAP / Web Servisi Yüklerinde Hata Ayıklama

Kurumsal API'lerden ve eski web servislerinden gelen SOAP yanıtları tek satırlık XML dizeleri olarak gelir. Ham yükü biçimlendirici içine yapıştırarak zarfın yapısını, başlıklarını ve gövdesini anında görün; ihtiyacınız olan alanı bulmanızı veya ad alanı uyuşmazlığını fark etmenizi kolaylaştırır. Yükü JavaScript'te daha ileri işlemeniz gerekiyorsa bkz: XML'den JSON'a Dönüştürücü.

Yapılandırma Dosyalarını ve Dağıtım Tanımlayıcılarını Doğrulama

Maven POM dosyaları, Spring XML uygulama bağlamları, Tomcat server.xml, Android Manifest dosyaları ve diğer pek çok Java/kurumsal yapılandırma dosyası XML'dir. Derleme veya dağıtım zamanında ortaya çıkacak eşleşmeyen etiketleri veya kodlama sorunlarını önceden yakalamak için kaydetmeden önce Doğrulama'ya alın.

RSS ve Atom Beslemesi Çıktısını Biçimlendirme

RSS 2.0 ve Atom 1.0 beslemeleri XML'dir. Besleme üreticisi geliştirirken veya besleme okuyucusu uyumluluk sorunlarını giderirken, kanal meta verilerini, öğe yapısını ve gerekli ad alanı bildirimlerini yan yana incelemek için ham besleme XML'ini biçimlendirin.

SVG Dosyalarını Okuma ve Düzenleme

Figma, Illustrator veya Sketch'ten dışa aktarılan SVG dosyaları geçerli XML'dir; ancak genellikle dışa aktarıcıdan gelen aşırı girintiyle küçültülmüş veya dolmuştur. Manuel olarak yolları, grupları veya stil niteliklerini düzenlemeden önce temiz, gezilebilir bir öğe ağacı elde etmek için SVG'yi biçimlendirin.

XML'i Depolama veya İletim için Hazırlama

XML'i bir veritabanı sütununda depolarken, API isteğinde JSON dize alanı olarak gönderirken veya mesaj kuyruğuna eklerken, gereksiz boşlukları temizlemek için önce Küçült'ü kullanın. Bu, yük boyutunu azaltır ve büyük girintili XML dizelerinde kaçış karakteri gerektiren denetim karakterleriyle boğulabilecek JSON ayrıştırıcılarındaki sorunları önler.

XML'i JSON'a Dönüştürme

Biçimlendirilmiş XML'i bir JavaScript uygulamasında veya REST API'sinde kullanmak üzere JSON'a dönüştürmeniz gerekiyorsa XML'den JSON'a Dönüştürücü aracımızı kullanın. Tersine — JSON yapısından XML oluşturmak için — JSON'dan XML'e Dönüştürücü aracını kullanın.

Teknik Ayrıntılar

XML Ayrıştırma için Tarayıcı DOMParser

XML ayrıştırma, tarayıcının yerel DOMParser'ını 'text/xml' MIME türüyle kullanır. Bu, tarayıcıda SVG ve XHTML oluşturmaya güç veren motorla aynıdır — tam XML 1.0 uyumludur ve iyi biçimlilik hatalarını satır ve sütun bilgileriyle raporlar. Belge iyi biçimli olmadığında DOMParser, hata mesajını ve konumunu içeren bir parsererror belgesi döndürür; bu araç bunu çıkartıp görüntüler.

Biçimlendirme için DOM Ağacı Serileştirme

Biçimlendirme, XML'i bir DOM ağacına ayrıştırarak ve ardından girintili çıktı üretmek için ağaçta özyinelemeli yürüyüş yaparak çalışır. Bu yaklaşım belgenin anlam yapısını korur: öğe iç içe geçmesi, metin içeriği, nitelikler, CDATA bölümleri, işleme talimatları ve yorumlar ayrıştırıldığı gibi geri serileştirilir. Yalnızca öğeler arası boşluk içeren metin düğümleri atılır.

Yalnızca Boşluklu Metin Düğümü Kaldırma Yoluyla Küçültme

Küçültme, aynı DOM ağacını dolaşarak içeriği tamamen boşluk (boşluk karakterleri, sekmeler, yeni satırlar) olan metin düğümlerini kaldırır. Karma veya boşluk dışı içerikli metin düğümleri — etiketler arasındaki gerçek veriler — hiçbir zaman kaldırılmaz. Nitelikler ve değerleri eklenen boşluk olmaksızın serileştirilir.

%100 Tarayıcı Tabanlı — Yükleme Yok, Sunucu Yok

Tüm işlem tarayıcınızın JavaScript çalışma zamanında gerçekleşir. Hiçbir veri hiçbir noktada hiçbir sunucuya iletilmez. Bu, hassas içerik barındıran XML yükleri için özellikle önemlidir: SOAP WS-Security belirteçleri, HL7 hasta verileri, dahili servis yapılandırması ve finansal mesaj formatları (FIX, SWIFT ISO 20022).

En İyi Uygulamalar

Biçimlendirmeden Önce Doğrulayın, Kaydetmeden Önce Biçimlendirin

Giriş geçerli XML değilse biçimlendirici yanlış çıktı üretebileceğinden, yeniden biçimlendirmeden önce XML'inizin iyi biçimli olduğunu doğrulayın. Doğrulandıktan sonra, yapılandırma dosyalarını, besleme şablonlarını veya WSDL tanımlarını sürüm kontrolüne göndermeden önce biçimlendirin ve girintili çıktıyı inceleyin.

Web Formatları için 2 Boşluk, Kurumsal XML için 4 Boşluk Kullanın

RSS/Atom beslemeleri, SVG, XHTML, Android XML ve çoğu web odaklı XML için iki boşluk girintisi standarttır. Dört boşluk girinti Java kurumsal ortamlarında (Maven POM, Spring bağlam dosyaları, JBoss dağıtım tanımlayıcıları) yaygındır. Mevcut dosyalarınızın ve araç zincirinizin kuralına uyun.

JSON'a Gömmeden Önce XML'i Küçültün

XML'i bir JSON alan değeri olarak gömmeniz gerekiyorsa, daima önce küçültün. Girintili XML, JSON ile kaçış karakteri eklenmesi gereken (\n, çoklu \u0020) yeni satırlar ve birden fazla boşluk içererek yük boyutunu önemli ölçüde şişirir. Küçültülmüş XML, aracı proxy'lerde veya günlük sistemlerinde satır uzunluğu sınırlarını tetikleme olasılığı da çok daha düşüktür.

Metin İçeriğindeki Özel Karakterleri Kaçış Karakteriyle Belirtin, CDATA'yı İdareli Kullanın

& veya < içeren kısa metin değerleri için varlık referanslarını (&, <) kullanın — bunlar CDATA bölümlerinden daha taşınabilirdir ve nitelik değerlerinde de çalışır. CDATA bölümlerini () büyük kod blokları, SQL sorguları veya her özel karakteri kaçış karakteriyle belirtmenin içeriği okunamaz hale getireceği HTML parçaları için saklayın.

Ad Alanlarını Mümkün Olduğunca Erken Bildirin

XML ad alanlarını (xmlns:prefix="URI") kök öğe üzerinde veya öneki kullanan en üst düzey öğede bildirin. Ad alanlarını bir belge ağacının derinliklerinde bildirmek, XML'i okumayı zorlaştırır ve ad alanlarını artımlı olarak işleyen akış tabanlı XML ayrıştırıcılarında (SAX, StAX) sorunlara yol açabilir. Yukarıdaki SOAP Zarfı örneği önerilen kalıbı göstermektedir: tüm ad alanı bildirimleri kök Envelope öğesinde.

Sıkça Sorulan Sorular