XSD

XSD

Documentos válidos

Um documento XML diz-se válido se, além de ser bem-formado, respeita também as restrições impostas por um esquema XSD (XML Schema Definition).

<mensagem xmlns="urn:empresa.pt:mensagem"
          id="49532"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="urn:empresa.pt:mensagem mensagem.xsd">
    <de>Manuel</de>
    <para>Francisco</para>
    <assunto>Almoço</assunto>
    <texto>Que tal um almoço na sexta?</texto>
</mensagem>

A linha xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" indica que o documento deve ser validado usando XSD.
A linha xsi:schemaLocation="urn:empresa.pt:mensagem mensagem.xsd" especifica onde o esquema reside (neste caso, estará na mesma directoria do ficheiro).
Existe também a variante xsi:noNamespaceSchemaLocation quando o documento a validar não está num espaço de nomes.

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            targetNamespace="urn:empresa.pt:mensagem"
            xmlns:tns="urn:empresa.pt:mensagem"
            elementFormDefault="qualified">
    <xsd:complexType name="MensagemType">
        <xsd:sequence>
            <xsd:element name="de" type="xsd:string"/>
            <xsd:element name="para" type="xsd:string"/>
            <xsd:element name="assunto" type="xsd:string"/>
            <xsd:element name="texto" type="xsd:string"/>
        </xsd:sequence>
        <xsd:attribute name="id" type="xsd:string" use="required"/>
    </xsd:complexType>
    <xsd:element name="mensagem" type="tns:MensagemType"/>
</xsd:schema>

A própria linguagem XSD é definida em XML! O elemento raíz chama-se 'schema'.

O exemplo apresentado é típico em vários aspectos:

• A definição dos tipos compostos (complexType) é separada da definição dos elementos (element), para garantir uma boa estruturação e ao mesmo tempo permitir maior reutilização.
• Os elementos simples são definidos recorrendo a tipos pré-definidos, nomeadamente, xsd:string. Outros tipos pré-definidos comuns são xsd:integer e xsd:date, mas existem muitos outros.
• Os elementos compostos são sequências de elementos, definidas num tipo complexo.

Existem outros aspectos a salientar:

• A cardinalidade (número de elementos filhos) é definida pelos atributos 'minOccurs' e 'maxOccurs'. Os valores por omissão são 1 e 1, o elementos deve aparecer no mínimo uma vez e no máximo uma vez, ou seja, exactamente uma vez!
• Os atributos são opcionais por omissão, mas o atributo 'id' é obrigatório devido a ter sido definido: use="required".

Vocabulários XML

Um esquema XSD especifica um vocabulário XML, que define:

• Os elementos que podem aparecer num documento
• Os atributos que podem aparecer num documento
• Que elementos são elementos filhos
• Qual a ordem dos elementos filhos
• Qual o número de elementos filhos
• Se um elemento é vazio ou pode conter texto
• Tipos de dados para elementos e atributos
• Valores fixos ou por omissão para elementos e atributos
• Restrições aos valores possíveis para um elemento ou atributo

A principal utilidade do XSD é permitir validar automaticamente documentos XML, sem necessidade de escrever um programa para o efeito.