· Woohyun Kim · Platform Engineering
WFF XML 스키마 설계 회고 3 — Validation의 목적과 경계
WFF의 실제 XSD 선언으로 검증하는 요소 관계·속성·타입과 값의 유일성을 설명합니다. 조건부 규칙의 표현 범위와 XSD 1.1의 지원을 살펴보고, 검증 요구를 통해 정의의 설계를 재검토하는 관점을 정리합니다.
WFF 명세를 XSD로 작성한 중요한 이유 중 하나는 정의 자체를 XML 검증에 사용할 수 있다는 점이었습니다. 이 글에서 validation은 워치페이스 XML이 XSD에 선언한 구조와 제약을 만족하는지 검사하는 유효성 검증을 의미합니다.
XSD는 표준이므로 이를 읽고 XML을 검사하는 API와 라이브러리를 활용할 수 있습니다. 예를 들어 Java에는 javax.xml.validation이 있습니다. 허용할 요소·속성·값을 스키마에 선언하면 그 규칙을 검사하기 위한 코드를 각각 구현할 필요가 줄어듭니다. 이는 XSD 도입 당시 개발과 유지보수 비용 측면에서 중요하게 본 이점이었습니다.
실제 예시: Group의 정의
이어지는 검증 규칙을 설명하기 위해 WFF의 Group 정의를 예로 들겠습니다. Group은 여러 렌더링 요소와 다른 Group을 하위에 묶는 컨테이너입니다. 아래 groupElement.xsd의 선언을 기준으로 자식 요소의 구성과 속성, 값의 검증을 살펴보겠습니다.
groupElement.xsd — XSD 정의 발췌
<xs:element name="Group">
<xs:complexType>
<xs:all>
<xs:element ref="Gyro" minOccurs="0" maxOccurs="1"/>
<xs:element ref="Transform" minOccurs="0" maxOccurs="unbounded"/>
<xs:element ref="Group" minOccurs="0" maxOccurs="unbounded"/>
<xs:element ref="PartImage" minOccurs="0" maxOccurs="unbounded"/>
<xs:element ref="PartAnimatedImage" minOccurs="0" maxOccurs="unbounded"/>
<!-- 기타 자식 요소 정의 생략 -->
</xs:all>
<xs:attribute name="name" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attributeGroup ref="geometricAttributesRequired"/>
<!-- 기타 속성 정의 생략 -->
</xs:complexType>
</xs:element>요소·속성·타입 선언으로 검증하는 규칙
허용되는 자식 요소와 출현 횟수
all은 허용되는 자식 요소와 각 요소의 출현 횟수를 정하면서, 서로 다른 종류의 자식을 어떤 순서로 나열할지는 고정하지 않습니다. 예를 들어 Group 안에서 PartImage와 Transform을 선언하는 순서는 이 구성 규칙으로 제한하지 않습니다.
이 밖에도 자식 요소의 선언 순서를 지정하는 sequence와, 허용된 여러 항목 중 하나를 선택하도록 하는 choice가 있습니다.
위 선언만으로 다음과 같은 구조적 규칙을 검사할 수 있습니다. minOccurs와 maxOccurs를 생략하면 기본값은 각각 1입니다.
| 자식 요소 | 허용하는 구성 | 검증 의미 |
|---|---|---|
Gyro | 생략하거나 하나 | 두 개 선언하면 실패 |
Transform, Group, PartImage, PartAnimatedImage | 각각 생략하거나 여러 개 | 각각의 개수에 상한이 없으며 함께 선언 가능 |
Group에 허용하지 않은 요소 | 직접 배치할 수 없음 | 예를 들어 Compare를 바로 아래에 선언하면 실패 |
minOccurs="0"은 생략 가능함을, unbounded는 출현 횟수의 상한이 없음을 뜻합니다.
속성의 종류와 필수 여부
속성도 요소에 선언한 attribute와 attributeGroup을 기준으로 검사합니다. 위 예시에서 Group.name은 use="required"이므로 반드시 작성해야 하고, minLength="1"이므로 빈 문자열도 허용하지 않습니다.
Group은 geometricAttributesRequired를 통해 x, y, width, height를 필수 속성으로 사용합니다. 이처럼 재사용한 속성 그룹의 제약도 해당 요소의 검증에 반영됩니다.
예를 들어 아래 Group은 필수 기하 속성과 name을 작성했습니다. width를 누락하거나, 정의에 없는 opacity 속성을 추가하면 이 요소의 스키마 검증에 실패합니다.
<Group name="clock" x="0" y="0" width="360" height="360" />XML 속성에는 선언 순서의 의미가 없으므로 위 속성들을 다른 순서로 작성해도 같습니다. 한 요소에 동일한 속성을 중복 작성할 수는 없습니다. 이러한 중복은 XSD의 추가 검증 이전에 XML의 well-formedness 규칙에 위배되어 파싱 단계에서 거부됩니다.
값의 타입과 범위
속성의 존재 여부뿐 아니라 값도 타입의 제약을 따릅니다. 예를 들어 기하 속성이 정수 타입을 사용한다면 width="wide"는 허용되지 않습니다.
색상 관련 정의인 argbHexadecimalType은 문자열에 다음과 같은 패턴 제약을 적용합니다.
<xs:simpleType name="argbHexadecimalType">
<xs:restriction base="xs:string">
<xs:pattern value="#([A-Fa-f0-9]{8}|[A-Fa-f0-9]{6})"/>
</xs:restriction>
</xs:simpleType>#FF336699와 #336699는 이 패턴에 부합하고, 16진수 문자가 아닌 G를 포함한 #GG336699나 색상 이름 blue는 부합하지 않습니다.
별도 검증 문법과 값의 유일성
앞에서는 요소·속성·타입을 정의하는 선언 자체가 검증 규칙이 되는 과정을 살펴봤습니다. XSD는 이와 별도로 값의 유일성이나 참조 관계를 검사하기 위한 문법도 제공합니다. 여기서는 xs:unique를 사용한 사례를 살펴보겠습니다.
watchface.xsd는 WatchFace 안에서 비트맵 폰트의 이름이 중복되지 않도록 다음 규칙을 선언합니다.
<xs:unique name="Validation.Unique.WatchFace.BitmapFonts.BitmapFont.name">
<xs:selector xpath="BitmapFonts/*"/>
<xs:field xpath="@name"/>
</xs:unique>selector는 검사할 요소 집합을 선택하고, field는 비교할 값을 지정합니다. 여기서는 BitmapFonts 아래에 선언한 폰트들의 name 값을 비교합니다.
폰트 내부의 Character와 Word 이름도 bitmapFontsElement.xsd에서 별도로 유일성을 검사합니다. 예를 들어 같은 폰트에 name="0"인 문자를 두 번 선언하면 이 제약에 위배됩니다.
XSD 1.1에는 조건을 직접 기술하는 xs:assert도 있습니다. 이 문법은 아래의 조건부 관계에서 살펴보겠습니다.
구조 선언만으로 충분하지 않은 규칙
도메인에 따라서는 기존의 요소·속성·타입을 정의하는 흐름 안에 담기 어려운 관계 규칙도 있을 수 있습니다.
형제 요소 사이의 조건부 관계
가령 ‘PartImage가 세 개 이상이면 같은 부모 아래에 PartAnimatedImage를 사용할 수 없다’는 규칙을 상상해볼 수 있습니다. 한 종류의 개수에 따라 다른 종류의 사용 가능 여부를 판단하는 조건으로, 각 요소의 출현 횟수를 개별적으로 선언하는 방식으로는 이 관계를 직접 기술할 수 없습니다.
요소와 속성을 함께 판단하는 관계
가령 ‘A 요소의 속성이 특정 값이면 B 요소의 특정 속성이 없어야 한다’는 규칙도 상상해볼 수 있습니다. 이 역시 각 요소와 속성의 정의에 타입과 필수 여부를 지정하는 것만으로는 직접 기술할 수 없는 관계입니다.
WFF의 Part는 x, y, width, height 같은 기하 속성과 하위 Transform을 동시에 허용합니다. 가령 ‘Transform이 있으면 부모의 기하 속성을 금지한다’는 규칙을 상상해볼 수 있지만, 이 역시 개별 요소·속성을 선언하는 기존의 정의 흐름에서는 직접 구현할 방법이 없다는 것입니다.
다행히도 실제 WFF에서 기하 속성은 기본적인 정적 기하 상태를, Transform은 런타임 동적 기하 변환을 정의합니다. 따라서 두 정의의 의미가 중복되지 않으며, 함께 사용해도 설계적인 충돌이 발생하지 않습니다.
XSD 1.1의 조건부 검증 지원
XSD 1.1의 xs:assert는 XPath 표현식으로 요소의 개수와 속성값을 함께 판단하는 검증 조건을 기술할 수 있게 합니다.
예를 들어 앞서 설명한 형제 요소의 조건을 부모의 복합 타입에 추가한다면 다음과 같이 표현할 수 있습니다.
<xs:assert test="count(PartImage) lt 3 or empty(PartAnimatedImage)"/>이는 자식 PartImage가 세 개 미만이거나, 그렇지 않으면 자식 PartAnimatedImage가 없어야 한다는 조건입니다.
여기서 주목할 점은 요소·속성의 구조를 선언하는 흐름과 별도로 검증 조건을 추가한다는 것입니다. xs:assert는 복합 타입 안에 배치할 수 있지만, 자식 요소나 속성을 정의하는 선언 자체로 그 관계를 표현하는 문법은 아닙니다.
검증 요구를 통한 정의의 재검토
검증 조건이 복잡해지는 것은 정의의 책임이나 관계가 불명확하다는 신호일 수 있습니다. 해당 조건이 도메인에 필요한 관계인지, 서로 다른 역할이 섞이거나 같은 개념의 의미가 사용처에 따라 달라지면서 생긴 조건인지 살펴보아야 할 것입니다. 이는 1편에서 설명한 well-definedness의 관점, 즉 각 정의와 그 관계가 명확하고 일관되게 해석되는지를 점검하는 과정입니다.
마지막으로 assert는 더 문법적으로 유연하고 강한 검증 수단을 제공하지만, 이를 통해 규칙을 추가하기 전에 정의의 책임과 경계가 적절한지 신중하게 검토할 필요가 있습니다.
시리즈 목차
코드 출처: 공개 WFF XSD 버전 1, Copyright 2023 Samsung Electronics Co., Ltd, Apache License 2.0. XSD 발췌에서는 annotation·include와 설명 대상 밖의 정의를 생략했습니다. XML 사용 예시와 assertion은 설명을 위해 별도로 작성했습니다.
참고: Java XML 검증 API, XML 속성의 유일성 규칙, XSD 1.0 Primer, XSD 1.1: Assertions.
- Wear OS
- WFF
- XML
- XSD
- Schema Design