How XML Schema Facets Restrict Primitive Data Types

XML Schema Definition (XSD) uses facets to define constraints on primitive data types, ensuring data conforms to strict business rules and structural requirements. By applying facets such as length limits, numeric boundaries, regular expression patterns, and enumerations inside an xs:restriction element, developers can derive specialized, validated simple types from generic built-in primitives like xs:string, xs:integer, and xs:decimal.

Understanding Facets in XML Schema

A facet is an XML element that defines a specific aspect of a value space. When a simple type is derived by restriction from a base primitive type, facets set the boundaries of what constitutes valid data. Facets act as validation filters, rejecting any XML document whose element or attribute values violate the defined parameters.

Restricting String Data Types

Primitive string types (such as xs:string and xs:normalizedString) can hold arbitrary text. Facets allow you to constrain length, enforce specific values, or dictate exact formatting.

• Length Constraints (xs:length, xs:minLength, xs:maxLength):
  • xs:length: Requires the string to have an exact number of characters.
  • xs:minLength: Defines the lower limit on the character count.
  • xs:maxLength: Defines the upper limit on the character count.
• Pattern Matching (xs:pattern): Defines a regular expression that the string must match. This is commonly used for formatted data such as telephone numbers, postal codes, and email addresses.
• Enumerations (xs:enumeration): Restricts the string to an explicit set of acceptable values, functioning like an enum in programming languages.
• Whitespace Handling (xs:whiteSpace): Instructs the processor how to handle whitespace characters using values like preserve, replace, or collapse.

String Restriction Example

<xs:simpleType name="ProductCodeType">
  <xs:restriction base="xs:string">
    <xs:pattern value="[A-Z]{3}-[0-9]{4}"/>
  </xs:restriction>
</xs:simpleType>

<xs:simpleType name="StatusType">
  <xs:restriction base="xs:string">
    <xs:enumeration value="Pending"/>
    <xs:enumeration value="Approved"/>
    <xs:enumeration value="Rejected"/>
  </xs:restriction>
</xs:simpleType>

Restricting Integer and Numeric Data Types

Numeric types such as xs:integer, xs:int, xs:byte, and xs:decimal can be constrained by value range and digit counts.

• Boundary Limits:
  • xs:minInclusive: The value must be greater than or equal to the specified number.
  • xs:maxInclusive: The value must be less than or equal to the specified number.
  • xs:minExclusive: The value must be strictly greater than the specified number.
  • xs:maxExclusive: The value must be strictly less than the specified number.
• Digit Precision Constraints:
  • xs:totalDigits: Specifies the maximum number of digits allowed in the number.
  • xs:fractionDigits: Specifies the maximum number of decimal places allowed (used with xs:decimal).

Integer Restriction Example

<xs:simpleType name="AgeType">
  <xs:restriction base="xs:integer">
    <xs:minInclusive value="0"/>
    <xs:maxInclusive value="120"/>
  </xs:restriction>
</xs:simpleType>

<xs:simpleType name="QuantityType">
  <xs:restriction base="xs:positiveInteger">
    <xs:maxExclusive value="1000"/>
    <xs:totalDigits value="3"/>
  </xs:restriction>
</xs:simpleType>

Summary of Common Facet Compatibility

By applying these facets within custom simple type definitions, XML Schemas enforce rigorous data integrity at the parser level before the data reaches application logic.