XSD 制限 / Facets
制限(restriction)は、XML要素または属性に受け入れ可能な値を定義するために使用されます。XML要素に対する制限はfacetと呼ばれます。
値に対する制限
次の例では、制限付きで"age"という名前の要素を定義しています。ageの値は0未満または120を超えることはできません:
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="120"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
値のセットに対する制限
XML要素の内容を一連の受け入れ可能な値に制限するには、列挙制約(enumeration constraint)を使用します。
次の例では、制限付きで"car"という名前の要素を定義しています。受け入れ可能な値はAudi、Golf、BMWのみです:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Audi"/>
<xs:enumeration value="Golf"/>
<xs:enumeration value="BMW"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
上記の例は次のようにも書くことができます:
<xs:simpleType name="carType">
<xs:restriction base="xs:string">
<xs:enumeration value="Audi"/>
<xs:enumeration value="Golf"/>
<xs:enumeration value="BMW"/>
</xs:restriction>
</xs:simpleType>
注意:この場合、型"carType"は"car"要素の一部ではないため、他の要素でも使用できます。
一連の値に対する制限
XML要素の内容を、使用可能な数字または文字の並びとして制限するには、パターン制約(pattern constraint)を使用します。
次の例では、制限付きで"letter"という名前の要素を定義しています。受け入れ可能な値は小文字のa〜zのうちの1文字だけです:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[a-z]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
次の例では、制限付きで"initials"という名前の要素を定義しています。受け入れ可能な値は大文字のA〜Zの3文字です:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[A-Z][A-Z][A-Z]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
次の例では、制限付きで"initials"という名前の要素も定義しています。受け入れ可能な値は大文字または小文字のa〜zの3文字です:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[a-zA-Z][a-zA-Z][a-zA-Z]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
次の例では、制限付きで"choice"という名前の要素を定義しています。受け入れ可能な値は文字x、y、zのいずれか1つです:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[xyz]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
次の例では、制限付きで"prodid"という名前の要素を定義しています。受け入れ可能な値は、各桁が0〜9の範囲である5つのアラビア数字の並びです:
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:pattern value="[0-9][0-9][0-9][0-9][0-9]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
一連の値に対するその他の制限
次の例では、制限付きで"letter"という名前の要素を定義しています。受け入れ可能な値はa〜zの0個以上の文字です:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="([a-z])*"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
次の例では、制限付きで"letter"という名前の要素を定義しています。受け入れ可能な値は、小文字1文字の後に大文字1文字が続く1組以上の文字のペアです。例えば、"sToP"はこのパターンの検証に合格しますが、"Stop"、"STOP"、"stop"は検証に合格しません:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="([a-z][A-Z])+"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
次の例では、制限付きで"gender"という名前の要素を定義しています。受け入れ可能な値はmaleまたはfemaleです:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="male|female"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
次の例では、制限付きで"password"という名前の要素を定義しています。受け入れ可能な値は8文字で構成される文字列で、これらの文字は大文字または小文字のa〜z、あるいは数字0〜9でなければなりません:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[a-zA-Z0-9]{8}"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
空白文字に対する制限
空白文字(whitespace characters)の処理方法を指定するには、whiteSpace制限を使用する必要があります。
次の例では、制限付きで"address"という名前の要素を定義しています。このwhiteSpace制限は"preserve"に設定されており、XMLプロセッサが空白文字を一切削除しないことを意味します:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="preserve"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
この例でも、制限付きで"address"という名前の要素を定義しています。このwhiteSpace制限は"replace"に設定されており、XMLプロセッサがすべての空白文字(改行、復帰、スペース、タブ)を削除することを意味します:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="replace"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
この例でも、制限付きで"address"という名前の要素を定義しています。このwhiteSpace制限は"collapse"に設定されており、XMLプロセッサがすべての空白文字を削除することを意味します(改行、復帰、スペース、タブはスペースに置き換えられ、先頭と末尾のスペースは削除され、連続する複数のスペースは単一のスペースに短縮されます):
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:whiteSpace value="collapse"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
長さに対する制限
要素内の値の長さを制限するには、length、maxLength、minLength制限を使用する必要があります。
次の例では、制限付きで"password"という名前の要素を定義しています。その値は正確に8文字でなければなりません:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:length value="8"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
この例でも、制限付きで"password"という名前の要素を定義しています。その値は最小5文字、最大8文字です:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="5"/>
<xs:maxLength value="8"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
データ型の制限
| 制限 | 説明 |
|---|---|
| enumeration | 許可される値のリストを定義します。 |
| fractionDigits | 許可される小数部の最大桁数を定義します。0以上である必要があります。 |
| length | 許可される文字またはリスト項目の正確な数を定義します。0以上である必要があります。 |
| maxExclusive | 数値の上限を定義します。許可される値はこの値より小さくなければなりません。 |
| maxInclusive | 数値の上限を定義します。許可される値はこの値以下でなければなりません。 |
| maxLength | 許可される文字またはリスト項目の最大数を定義します。0以上である必要があります。 |
| minExclusive | 数値の下限を定義します。許可される値はこの値より大きくなければなりません。 |
| minInclusive | 数値の下限を定義します。許可される値はこの値以上でなければなりません。 |
| minLength | 許可される文字またはリスト項目の最小数を定義します。0以上である必要があります。 |
| pattern | 許可される文字の正確な並びを定義します。 |
| totalDigits | 許可されるアラビア数字の正確な桁数を定義します。0より大きい必要があります。 |
| whiteSpace | 空白文字(改行、復帰、スペース、タブ)の処理方法を定義します。 |