XSD 검증기

적격 XML 문서도 여전히 틀릴 수 있습니다: 필수 요소가 빠졌거나, 속성에 잘못된 데이터 타입을 썼거나, 요소가 잘못된 순서로 있을 수 있습니다. XSD(XML Schema Definition)는 문서가 정확히 어떻게 생겨야 하는지 기술합니다. 이 검증기는 XML과 그 XSD를 짝지어 W3C XML Schema 검증기를 돌리고, 검증기 메시지를 행 번호와 함께 보여 줍니다.

XSD에 대해 XML을 검증하는 방법

  1. 1

    두 파일 붙여넣기

    한쪽에는 XML, 다른 쪽에는 XSD 스키마 하나를 넣습니다. 스키마는 독립적으로 완결되어야 하며, xs:include나 xs:import로 가져오는 파일은 불러오지 않습니다.

  2. 2

    검증 실행

    파서가 요소, 속성, 타입을 스키마 선언에 대해 대조합니다.

  3. 3

    오류 검토

    각 문제에는 행 번호와 검증기 메시지가 표시되며, 메시지에는 보통 요소와 위반된 제약이 나옵니다.

  4. 4

    고치고 재검증

    첫 단계로 돌아가 XML이나 스키마를 고친 뒤 다시 검증하세요.

XSD가 점검하는 것

  • 요소 이름과 개수: 필수, 선택, 최소/최대 출현 횟수.
  • 요소 순서: sequence, choice, all.
  • 속성 존재와 타입: 필수 vs 선택, 기본값, 고정값.
  • 데이터 타입: xs:string, xs:integer, xs:decimal, xs:dateTime, xs:boolean, xs:anyURI, 사용자 정의.
  • 제약: 최소/최대 길이, 열거, 정규식 패턴, 최소/최대 값.
  • 참조 무결성: 교차 요소 제약을 위한 xs:key, xs:keyref, xs:unique.

전형적인 오류

오류 XSD 제약
필수 요소 <email> 누락 minOccurs="1"
<phone> 요소가 너무 많음 maxOccurs="2" 초과
값 “abc”가 유효한 정수가 아님 type="xs:integer"
값 “user.example.com”가 패턴과 불일치 xs:string의 xs:pattern
요소가 순서를 벗어남 xs:sequence
알 수 없는 요소 <foo> 스키마에 선언되지 않음
중복 키 xs:unique 위반

XSD와 대안 사이 선택

  • XSD: W3C 표준, 장황하고 강력하며 널리 지원됩니다. 엔터프라이즈 XML의 첫 선택.
  • RELAX NG: 더 단순한 구문, 동등하게 표현력 있음. 문서 형식(DocBook, TEI)에서 인기.
  • Schematron: 규칙 기반, 문서에 대해 XPath 단언을 실행. 구조를 넘는 비즈니스 규칙에 좋음.
  • DTD: 더 오래되고 훨씬 덜 표현력 있음. HTML 역사적 호환을 위해 여전히 사용됨.

많은 프로젝트가 구조에는 XSD를, 복잡한 교차 필드 규칙에는 Schematron을 씁니다.

흔한 함정

  • 네임스페이스가 일치해야 합니다. XSD가 targetNamespace="http://example.com"을 선언했는데 XML이 그 네임스페이스를 쓰지 않으면 “선언을 찾을 수 없음”으로 검증이 실패합니다.
  • xs:anyType는 마법의 탈출구가 아닙니다. 무엇이든 일치시키지만 검증을 전혀 제공하지 않습니다.
  • 기본값은 속성이 없을 때만 적용됩니다. 명시적 빈 값(attr="")은 기본값을 받지 않습니다.
  • 공백 처리는 타입마다 다릅니다. xs:string은 보존하고, xs:token은 합치며, xs:normalizedString은 탭/줄바꿈을 공백으로 바꿉니다.

디버깅 워크플로

  1. 먼저 스키마 없이 검증(적격성 점검). 파싱 오류를 고치세요.
  2. 그다음 스키마에 대해 검증.
  3. 첫 오류에 집중하세요. XSD 검증기는 때때로 오류를 연쇄시킵니다. 첫째가 보통 가장 실행 가능합니다.
  4. 큰 문서에서는 XPath로 문제 요소를 찾으세요.

자주 묻는 질문

아니요. 첫 번째 칸에 XML을, 두 번째 칸에 스키마를 붙여 넣으세요. XML의 xsi:schemaLocation 참조는 따르지 않으며, 검증기는 항상 붙여 넣은 스키마를 사용합니다.

일반적으로는 가능합니다. 여러 네임스페이스가 섞인 문서는 네임스페이스마다 스키마가 필요합니다. 이 도구는 붙여 넣은 스키마 하나로만 검증하며 xs:include나 xs:import에 지정된 파일은 불러오지 않고, 불러오지 않았다고 알려 줍니다. 그 파일들이 기본 스키마와 같은 네임스페이스라면 선언을 기본 스키마에 복사해 넣으세요.

XSD 1.0. 기반이 되는 libxml 엔진은 XSD 1.1을 구현하지 않으므로, 단언, 조건부 타입, open content 같은 1.1 전용 기능은 적용되지 않습니다.

아니요. XML과 스키마는 해당 단일 요청의 검증을 실행하기 위해서만 서버로 전송되며, 이후 저장되거나 기록되지 않습니다.

관련 도구

이 도구는 다른 언어로도 제공됩니다