Как определить пользовательский тип данных в XML?

Ответ

Пользовательские типы данных в XML определяются через XML Schema (XSD).

1. Простой тип с ограничениями

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:simpleType name="Age">
        <xs:restriction base="xs:int">
            <xs:minInclusive value="0"/>
            <xs:maxInclusive value="150"/>
        </xs:restriction>
    </xs:simpleType>
    
    <xs:element name="person">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="age" type="Age"/>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

2. Сложный тип

<xs:complexType name="Address">
    <xs:sequence>
        <xs:element name="street" type="xs:string"/>
        <xs:element name="city" type="xs:string"/>
        <xs:element name="zipcode" type="xs:string"/>
    </xs:sequence>
</xs:complexType>

<xs:complexType name="Person">
    <xs:sequence>
        <xs:element name="name" type="xs:string"/>
        <xs:element name="address" type="Address"/>
    </xs:sequence>
</xs:complexType>

3. Тип с атрибутами

<xs:complexType name="Product">
    <xs:sequence>
        <xs:element name="name" type="xs:string"/>
        <xs:element name="price" type="xs:decimal"/>
    </xs:sequence>
    <xs:attribute name="id" type="xs:ID" use="required"/>
</xs:complexType>

4. Union Type

<xs:simpleType name="StringOrNumber">
    <xs:union memberTypes="xs:string xs:int"/>
</xs:simpleType>

5. List Type

<xs:simpleType name="IntegerList">
    <xs:list itemType="xs:int"/>
</xs:simpleType>

6. Extension (наследование)

<xs:complexType name="Employee">
    <xs:sequence>
        <xs:element name="name" type="xs:string"/>
        <xs:element name="id" type="xs:int"/>
    </xs:sequence>
</xs:complexType>

<xs:complexType name="Manager">
    <xs:complexContent>
        <xs:extension base="Employee">
            <xs:sequence>
                <xs:element name="department" type="xs:string"/>
            </xs:sequence>
        </xs:extension>
    </xs:complexContent>
</xs:complexType>

7. Enum (перечисление)

<xs:simpleType name="Status">
    <xs:restriction base="xs:string">
        <xs:enumeration value="ACTIVE"/>
        <xs:enumeration value="INACTIVE"/>
        <xs:enumeration value="PENDING"/>
    </xs:restriction>
</xs:simpleType>

8. Pattern (регулярные выражения)

<xs:simpleType name="Email">
    <xs:restriction base="xs:string">
        <xs:pattern value="[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}"/>
    </xs:restriction>
</xs:simpleType>

9. Использование в Java с JAXB

import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name = "person")
public class Person {
    @XmlElement
    private String name;
    
    @XmlElement
    private int age;
    
    @XmlElement
    private Address address;
}

10. Валидация в Java

import javax.xml.XMLConstants;
import javax.xml.validation.Schema;
import javax.xml.validation.SchemaFactory;
import javax.xml.validation.Validator;

public class XMLValidator {
    public static boolean validateXML(String xmlFile, String schemaFile) 
            throws Exception {
        SchemaFactory factory = SchemaFactory
            .newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI);
        Schema schema = factory.newSchema(new File(schemaFile));
        Validator validator = schema.newValidator();
        
        try {
            validator.validate(new StreamSource(new File(xmlFile)));
            return true;
        } catch (Exception e) {
            return false;
        }
    }
}

Ключевые элементы XSD

• simpleType - простой тип (строка, число, и т.д.)
• complexType - сложный тип (структура с несколькими элементами)
• restriction - ограничение значений
• extension - расширение существующего типа
• union - объединение нескольких типов
• enumeration - перечисление допустимых значений
• pattern - регулярное выражение для валидации

Лучшие практики

1. Определяйте все пользовательские типы в начале XSD
2. Переиспользуйте типы избегая дублирования
3. Документируйте типы и их ограничения
4. Используйте enum для строго определённых наборов
5. Добавляйте pattern для валидации строк
6. Тестируйте XML на соответствие XSD
7. Используйте JAXB для маршаллинга/демаршаллинга

В своём опыте я проектировал XSD схемы для интеграции с внешними системами, содержащие более 50 пользовательских типов данных с множественными ограничениями и расширениями.