XSD 制限 / Facets


制限(restriction)は、XML要素または属性に受け入れ可能な値を定義するために使用されます。XML要素に対する制限はfacetと呼ばれます。


値に対する制限

次の例では、制限付きで"age"という名前の要素を定義しています。ageの値は0未満または120を超えることはできません:

<xs:element name="age">
  <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:element name="car">
  <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:element name="car" type="carType"/>

<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:element name="letter">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:pattern value="[a-z]"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

次の例では、制限付きで"initials"という名前の要素を定義しています。受け入れ可能な値は大文字のA〜Zの3文字です:

<xs:element name="initials">
  <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:element name="initials">
  <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:element name="choice">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:pattern value="[xyz]"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

次の例では、制限付きで"prodid"という名前の要素を定義しています。受け入れ可能な値は、各桁が0〜9の範囲である5つのアラビア数字の並びです:

<xs:element name="prodid">
  <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:element name="letter">
  <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:element name="letter">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:pattern value="([a-z][A-Z])+"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

次の例では、制限付きで"gender"という名前の要素を定義しています。受け入れ可能な値はmaleまたはfemaleです:

<xs:element name="gender">
  <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:element name="password">
  <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:element name="address">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:whiteSpace value="preserve"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

この例でも、制限付きで"address"という名前の要素を定義しています。このwhiteSpace制限は"replace"に設定されており、XMLプロセッサがすべての空白文字(改行、復帰、スペース、タブ)を削除することを意味します:

<xs:element name="address">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:whiteSpace value="replace"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

この例でも、制限付きで"address"という名前の要素を定義しています。このwhiteSpace制限は"collapse"に設定されており、XMLプロセッサがすべての空白文字を削除することを意味します(改行、復帰、スペース、タブはスペースに置き換えられ、先頭と末尾のスペースは削除され、連続する複数のスペースは単一のスペースに短縮されます):

<xs:element name="address">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:whiteSpace value="collapse"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>


長さに対する制限

要素内の値の長さを制限するには、length、maxLength、minLength制限を使用する必要があります。

次の例では、制限付きで"password"という名前の要素を定義しています。その値は正確に8文字でなければなりません:

<xs:element name="password">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:length value="8"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

この例でも、制限付きで"password"という名前の要素を定義しています。その値は最小5文字、最大8文字です:

<xs:element name="password">
  <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 空白文字(改行、復帰、スペース、タブ)の処理方法を定義します。
その他の拡張