Walidator XML

Czym jest walidacja XML?

Walidator XML sprawdza, czy dokument XML spełnia reguły strukturalne zdefiniowane w specyfikacji XML 1.0 (zalecenie W3C, wydanie piąte). Podstawowym zadaniem tego walidatora XML jest potwierdzenie, że dokument jest poprawnie uformowany: ma jeden element główny, wszystkie tagi są prawidłowo zagnieżdżone i zamknięte, wartości atrybutów są ujęte w cudzysłowy, a znaki zarezerwowane używają predefiniowanych encji. Dokument, który nie spełnia któregokolwiek z tych wymagań, spowoduje, że parsery XML zgłoszą błędy zamiast po cichu produkować nieprawidłowe dane wyjściowe.

Rozróżnienie między poprawnym uformowaniem a walidacją ma istotne znaczenie. Poprawnie uformowany dokument XML spełnia reguły składniowe samej specyfikacji XML. Ważny dokument XML idzie dalej: jest zgodny z ograniczeniami zdefiniowanymi w zewnętrznym schemacie, takim jak DTD (Document Type Definition), XSD (XML Schema Definition) lub schemat Relax NG. To narzędzie sprawdza poprawne uformowanie — pierwszy i najczęstszy krok walidacji. Bez niego żaden dalszy etap przetwarzania nie może się rozpocząć.

Walidacja XML wykrywa błędy zanim trafią do środowiska produkcyjnego. Niezamknięte tagi, niezgodne nazwy elementów, nieeskejpowane ampersandy i zduplikowane atrybuty należą do najczęstszych błędów w ręcznie edytowanym XML. Parsery w różnych językach obsługują te błędy inaczej: niektóre kończą działanie bez komunikatu, inne zwracają częściowe wyniki, jeszcze inne rzucają wyjątki. Przepuszczenie XML przez walidator eliminuje tę niejednoznaczność i daje jednoznaczną odpowiedź: przeszedł lub nie przeszedł, wraz z informacją o lokalizacji błędu.

Dlaczego warto używać internetowego walidatora XML?

Wczesne wykrywanie błędów składniowych XML zapobiega kaskadowym awariom w aplikacjach przetwarzających dane XML. Walidator działający w przeglądarce daje natychmiastową informację zwrotną bez konieczności instalowania narzędzi wiersza poleceń ani konfigurowania wtyczek IDE.

Zastosowania walidatora XML

Reguły poprawnego uformowania XML

Specyfikacja XML 1.0 definiuje ścisły zestaw reguł składniowych. Dokument musi spełniać je wszystkie, aby być uznany za poprawnie uformowany. Poniższa tabela zawiera każdą regułę, jej wymagania i poprawny przykład. Większość błędów walidacji wynika z naruszenia jednej z tych reguł.

Poprawnie uformowany vs. ważny DTD vs. ważny względem schematu

Walidacja XML ma trzy poziomy. To narzędzie sprawdza pierwszy (poprawne uformowanie), który jest warunkiem wstępnym dla pozostałych dwóch.

Przykłady kodu

Waliduj XML programistycznie w różnych językach. Każdy przykład sprawdza poprawne uformowanie i zwraca komunikat błędu, jeśli dokument jest nieprawidłowy.

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

Często zadawane pytania