XSD Ограничения / фасеты


Ограничения используются для определения допустимых значений XML-элементов или атрибутов. Ограничения на XML-элементы называются фасетами.


Ограничения на значения

В следующем примере определяется элемент с именем "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-элемента набором допустимых значений, мы используем ограничение перечисления.

В следующем примере определяется элемент с именем "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.

В следующем примере определяется элемент с именем "letter" с ограничением. Допустимые значения — только одна из строчных букв a - z:

<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:

<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:

<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:

<xs:element name="choice">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:pattern value="[xyz]"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

В следующем примере определяется элемент с именем "prodid" с ограничением. Допустимые значения — последовательность из пяти арабских цифр, каждая цифра в диапазоне 0-9:

<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:

<xs:element name="letter">
  <xs:simpleType>
    <xs:restriction base="xs:string">
      <xs:pattern value="([a-z])*"/>
    </xs:restriction>
  </xs:simpleType>
</xs:element>

В следующем примере определяется элемент с именем "letter" с ограничением. Допустимые значения — одна или несколько пар букв, каждая пара состоит из строчной буквы, за которой следует прописная буква. Например, "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.

В следующем примере определяется элемент с именем "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 Определяет, как обрабатываются символы пробелов (переводы строк, возвраты каретки, пробелы и табуляции).
Другие расширения