XML Doğrulayıcı

XML Doğrulama Nedir?

Bir XML doğrulayıcı, bir XML belgesinin XML 1.0 belirtimi (W3C Önerisi, beşinci sürüm) tarafından tanımlanan yapısal kurallara uyup uymadığını denetler. Bu XML doğrulayıcı, en temel düzeyde bir belgenin iyi biçimlendirilmiş olduğunu doğrular: tek bir kök öğesi vardır, tüm etiketler düzgün iç içe yerleştirilmiş ve kapatılmıştır, öznitelik değerleri tırnak içindedir ve ayrılmış karakterler önceden tanımlanmış varlıkları kullanır. Bu denetimlerden herhangi birini geçemeyen bir belge, XML ayrıştırıcılarının sessizce hatalı çıktı üretmek yerine hata fırlatmasına neden olur.

İyi biçimlendirilmiş olma ile geçerlilik arasındaki fark önemlidir. İyi biçimlendirilmiş bir XML belgesi, XML belirtiminin sözdizimi kurallarını karşılar. Geçerli bir XML belgesi ise daha da ileri giderek DTD (Belge Türü Tanımı), XSD (XML Şema Tanımı) veya Relax NG şeması gibi harici bir şemada tanımlanan kısıtlamalara da uyar. Bu araç, en yaygın ilk doğrulama adımı olan iyi biçimlendirilmiş olma denetimini gerçekleştirir. Bu adım olmadan, ardından gelen hiçbir işlem ilerleyemez.

XML doğrulama, hataları canlı ortama ulaşmadan önce yakalar. Kapatılmamış etiketler, uyumsuz öğe adları, kaçışlanmamış ve işaretleri ve yinelenen öznitelikler, elle düzenlenen XML'deki en yaygın hatalar arasındadır. Farklı dillerdeki ayrıştırıcılar bu hataları farklı şekillerde ele alır: bir kısmı sessizce başarısız olur, bir kısmı kısmi sonuçlar döndürür, bir kısmı ise istisna fırlatır. XML'nizi bir doğrulayıcıdan geçirmek bu belirsizliği ortadan kaldırır ve hata konumu ayrıntılarıyla birlikte net bir geçti-kaldı sonucu verir.

Neden Çevrimiçi XML Doğrulayıcı Kullanmalısınız?

XML sözdizimi hatalarını erkenden yakalamak, XML verisi kullanan uygulamalardaki zincirleme hataları önler. Tarayıcı tabanlı bir doğrulayıcı, komut satırı araçları kurmadan veya IDE eklentileri yapılandırmadan anında geri bildirim sunar.

XML Doğrulayıcı Kullanım Senaryoları

XML İyi Biçimlendirilmiş Olma Kuralları

XML 1.0 belirtimi, katı bir sözdizimi kuralları kümesi tanımlar. İyi biçimlendirilmiş kabul edilmek için bir belge bunların tamamını karşılamalıdır. Aşağıdaki tablo her kuralı, gereksinimlerini ve doğru bir örneği listeler. Doğrulama hatalarının büyük çoğunluğu bu kurallardan birine dayanır.

İyi Biçimlendirilmiş, DTD-Geçerli ve Şema-Geçerli Karşılaştırması

XML doğrulamanın üç düzeyi vardır. Bu araç, diğer ikisinin ön koşulu olan birinci düzeyi (iyi biçimlendirilmiş olma) denetler.

Kod Örnekleri

Farklı dillerde XML'yi programatik olarak doğrulayın. Her örnek iyi biçimlendirilmiş olup olmadığını kontrol eder ve belge hatalı biçimlendirilmişse hata mesajını döndürür.

function validateXML(xmlString) {
  const parser = new DOMParser()
  const doc = parser.parseFromString(xmlString, 'application/xml')
  const error = doc.querySelector('parsererror')
  if (error) {
    return { valid: false, message: error.textContent }
  }
  return { valid: true, message: 'Well-formed XML' }
}

validateXML('<root><item>hello</item></root>')
// → { valid: true, message: "Well-formed XML" }

validateXML('<root><item>hello</root>')
// → { valid: false, message: "Opening and ending tag mismatch..." }

import xml.etree.ElementTree as ET

def validate_xml(xml_string):
    try:
        ET.fromstring(xml_string)
        return True, "Well-formed XML"
    except ET.ParseError as e:
        return False, str(e)

valid, msg = validate_xml('<root><item>hello</item></root>')
# → (True, "Well-formed XML")

valid, msg = validate_xml('<root><item>hello</root>')
# → (False, "mismatched tag: line 1, column 27")

# With lxml — also supports XSD schema validation
from lxml import etree
schema = etree.XMLSchema(etree.parse('schema.xsd'))
doc = etree.fromstring(b'<root><item>hello</item></root>')
schema.validate(doc)  # → True or False

package main

import (
    "encoding/xml"
    "fmt"
    "strings"
)

func validateXML(raw string) error {
    decoder := xml.NewDecoder(strings.NewReader(raw))
    for {
        _, err := decoder.Token()
        if err != nil {
            if err.Error() == "EOF" {
                return nil
            }
            return err
        }
    }
}

func main() {
    err := validateXML("<root><item>hello</item></root>")
    fmt.Println(err) // → <nil>

    err = validateXML("<root><item>hello</root>")
    fmt.Println(err) // → XML syntax error: unexpected end element </root>
}

# Check well-formedness (part of libxml2, pre-installed on macOS/Linux)
xmllint --noout document.xml
# Exit code 0 = valid, non-zero = errors printed to stderr

# Validate against an XSD schema
xmllint --noout --schema schema.xsd document.xml

# Validate against a DTD
xmllint --noout --dtdvalid schema.dtd document.xml

# Validate from stdin
echo '<root><unclosed>' | xmllint --noout -
# → :1: parser error : Premature end of data in tag unclosed line 1

Sıkça Sorulan Sorular