사용 방법
- XML 입력창에 검사할 XML 을 붙여넣습니다. 처음에는 예시가 들어 있습니다.
- 문법에 오류가 있으면 몇 번째 줄, 몇 번째 칸인지와 원인을 알려주고, 그 주변 줄을 강조해서 보여 줍니다.
- 문법이 올바르면 요소 수, 속성 수, 깊이, 네임스페이스와 요소별 개수를 요약해 줍니다.
- XSD 스키마로도 검사하려면 XSD 스키마로도 검사를 켜고 XSD 를 붙여넣습니다. 요소 순서, 반복 횟수, 필수 속성, 값 형식을 확인한 결과가 표로 나옵니다.
두 가지 검사
| 검사 | 확인하는 것 | 필요한 것 |
|---|---|---|
| 문법(well-formed) | 태그가 짝을 이루는지, 루트 요소가 하나인지, 속성 값에 따옴표가 있는지, 엔티티와 이름 규칙 | XML 만 |
| 스키마(valid) | 문서가 XSD 의 구조와 타입 규칙을 지키는지 | XML + XSD |
문법 검사는 브라우저의 XML 파서(DOMParser)가 판정하고, 이 도구가 그 메시지에서 줄·칸을 뽑아 원인을 한국어로 풀어 줍니다. 문법에 오류가 있으면 XSD 검사는 하지 않습니다. 스키마를 비교하려면 먼저 문서가 잘 짜여 있어야 하기 때문입니다.
XSD 검사가 지원하는 범위
- 요소: 전역·지역
element,ref,sequence,choice,all,group,any,minOccurs,maxOccurs - 타입:
complexType(extension, restriction, simpleContent, mixed), 이름 있는simpleType,list,union - 속성:
attribute,attributeGroup,use(required·optional·prohibited),fixed - 값 제한:
enumeration,pattern,length,minLength,maxLength,minInclusive,maxInclusive,minExclusive,maxExclusive,totalDigits,fractionDigits - 내장 타입: string 계열, boolean, 정수 계열(int, long, positiveInteger 등 범위 포함), decimal, float, double, date, dateTime, time, duration, gYear, language, NCName, hexBinary 등
key, keyref, unique, substitutionGroup, import, include 는 지원하지 않아 건너뛰고, 건너뛴 기능은 결과 아래에 알려 줍니다. 네임스페이스는 접두사를 떼고 이름으로만 비교합니다. 그래서 같은 이름의 요소가 다른 네임스페이스에 있는 문서는 정확히 구분하지 못합니다.
예시 결과
입력창의 예시 XML 과 XSD 로 검사하면 문법은 통과하고 스키마 위반이 2건 나옵니다.
- 2번째 줄:
<order>에 XSD 가 선언하지 않은 속성memo가 있음 - 6번째 줄:
<qty>의 값 “0” 이 positiveInteger(1 이상의 정수) 형식이 아님
maxOccurs 를 지정하지 않은 요소는 정확히 한 번만 나올 수 있고, 선택 요소는 minOccurs="0" 이어야 한다는 점도 위반의 흔한 원인입니다.
자주 나오는 문법 오류
- 여는 태그와 닫는 태그 이름이 다름: 대소문자도 구분합니다.
<Item></item>은 오류입니다. - 속성 값에 따옴표 없음: HTML 과 달리 XML 은
id=1을 허용하지 않고id="1"이어야 합니다. &를 그대로 씀:&로 써야 합니다. URL 의?a=1&b=2가 흔한 원인입니다.<도<로 씁니다.- 루트 요소가 둘 이상: 문서의 최상위 요소는 하나여야 합니다.
- XML 선언 앞에 공백:
<?xml ... ?>는 문서 맨 처음이어야 합니다.
자주 묻는 질문
well-formed 와 valid 는 무엇이 다른가요?
well-formed 는 XML 문법을 지킨 상태이고, valid 는 거기에 더해 DTD 나 XSD 같은 스키마의 규칙까지 지킨 상태입니다. 문법만 맞아도 스키마에는 맞지 않을 수 있습니다.
XSD 를 어떻게 만드나요?
손으로 쓰기 번거롭다면 XSD 생성기에 샘플 XML 을 넣어 초안을 만든 뒤, 이 도구에 붙여넣고 enumeration 이나 필수 속성 같은 제한을 직접 보강하세요.
오류가 한 번에 하나만 나오는 이유는 무엇인가요?
문법 오류에서는 파서가 첫 번째 오류에서 멈춥니다. 하나를 고치고 다시 보면 다음 오류가 나옵니다. XSD 위반은 최대 100건까지 한 번에 보여 줍니다.
파일로 저장된 XML 의 인코딩도 검사하나요?
아니요. 이 도구는 붙여넣은 글자를 검사하므로 파일의 실제 바이트 인코딩은 보지 않습니다. 선언의 encoding 이 UTF-8 이 아니면 참고 안내를 보여 줍니다.
관련 도구: XML 포맷터, XSD 생성기, XML CSV 변환기, HTML 문법 검사기, JSON 포맷터.
입력한 XML 과 XSD 는 브라우저 안에서만 검사되며 서버로 전송되지 않습니다.