XSD Ограничения / фасеты
Ограничения используются для определения допустимых значений XML-элементов или атрибутов. Ограничения на XML-элементы называются фасетами.
Ограничения на значения
В следующем примере определяется элемент с именем "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-элемента набором допустимых значений, мы используем ограничение перечисления.
В следующем примере определяется элемент с именем "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.
В следующем примере определяется элемент с именем "letter" с ограничением. Допустимые значения — только одна из строчных букв a - z:
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[a-z]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
В следующем примере определяется элемент с именем "initials" с ограничением. Допустимые значения — три прописные буквы A - Z:
<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: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:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[xyz]"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
В следующем примере определяется элемент с именем "prodid" с ограничением. Допустимые значения — последовательность из пяти арабских цифр, каждая цифра в диапазоне 0-9:
<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:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="([a-z])*"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
В следующем примере определяется элемент с именем "letter" с ограничением. Допустимые значения — одна или несколько пар букв, каждая пара состоит из строчной буквы, за которой следует прописная буква. Например, "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.
В следующем примере определяется элемент с именем "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 | Определяет, как обрабатываются символы пробелов (переводы строк, возвраты каретки, пробелы и табуляции). |