Тип аннотации XmlSchema

@Retention(value=RUNTIME)
 @Target(value=PACKAGE)
public @interface XmlSchema

Сопоставляет имя пакета с пространством имен XML.

Использование

Аннотация XmlSchema может использоваться с следующими элементами программы:

• пакет

Это аннотация уровня пакета и следует рекомендациям и ограничениям, содержащимся в JSR 175, раздел III, "Аннотации". Таким образом, её использование подчиняется следующим ограничениям и рекомендациям.

• Может быть только одна декларация пакета, как указано в JSR 175, раздел III, "Аннотации".
• JSR 175 рекомендует package-info.java для аннотаций уровня пакета. JAXB-провайдеры, которые следуют этой рекомендации, позволят определять аннотации уровня пакета в package-info.java.

Пример 1: Изменить имя пространства имен XML, к которому сопоставляется пакет.

@javax.xml.bind.annotation.XmlSchema (
      namespace = "http://www.example.com/MYPO1"
    )

    <!-- XML Schema fragment -->
    <schema
      xmlns=...
      xmlns:po=....
      targetNamespace="http://www.example.com/MYPO1"
    >
    <!-- prefixes generated by default are implementation
            depedenent -->

Пример 2: Изменить сопоставление префикса пространства имён, URI пространства имён

// Package level annotation
    @javax.xml.bind.annotation.XmlSchema (
      xmlns = {
        @javax.xml.bind.annotation.XmlNs(prefix = "po",
                   namespaceURI="http://www.example.com/myPO1"),

        @javax.xml.bind.annotation.XmlNs(prefix="xs",
                   namespaceURI="http://www.w3.org/2001/XMLSchema")
      )
    )

    <!-- XML Schema fragment -->
    <schema
        xmlns:xs="http://www.w3.org/2001/XMLSchema"
        xmlns:po="http://www.example.com/PO1"
        targetNamespace="http://www.example.com/PO1">

Пример 3: Изменить элементFormDefault

@javax.xml.bind.annotation.XmlSchema (
      elementFormDefault=XmlNsForm.UNQUALIFIED
      ...
    )

    <!-- XML Schema fragment -->
    <schema
        xmlns="http://www.w3.org/2001/XMLSchema"
        xmlns:po="http://www.example.com/PO1"
        elementFormDefault="unqualified">

Поля

NO_LOCATION

public static final String NO_LOCATION

Значение по умолчанию атрибута location(), которое указывает, что генератор схемы будет генерировать компоненты в этом пространстве имен.

Элементы

xmlns

public abstract XmlNs[] xmlns

Настройка ассоциаций URI пространства имен, префикса. По умолчанию, префиксы пространства имен для пространства имен XML генерируются JAXB-провайдером способом, зависящим от реализации.

По умолчанию:

{}

namespace

public abstract String namespace

Имя пространства имен XML.

По умолчанию:

""

elementFormDefault

public abstract XmlNsForm elementFormDefault

Квалификация пространства имен для элементов. По умолчанию, атрибут element default будет отсутствовать во фрагменте XML-схемы.

По умолчанию:

javax.xml.bind.annotation.XmlNsForm.UNSET

attributeFormDefault

public abstract XmlNsForm attributeFormDefault

Квалификация пространства имен для атрибутов. По умолчанию, атрибут attributeFormDefault будет отсутствовать во фрагменте XML-схемы.

По умолчанию:

javax.xml.bind.annotation.XmlNsForm.UNSET

location

public abstract String location

С:

JAXB2.1

По умолчанию:

"##generate"