javax.xml.bind.annotation

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

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

Отображает имя пакета к пространству имен XML.

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

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

• пакет

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

• Может только быть одно объявление пакета как отмечено в JSR 175, разделить III, "Аннотации".
• JSR 175 рекомендует пакет-info.java для аннотаций уровня пакета. Провайдеры JAXB, которые следуют за этой рекомендацией, позволят аннотациям уровня пакета быть определенными в пакете-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: префикс пространства имен Customize, отображение 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: Настройте elementFormDefault

    @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">

 

С тех пор:

JAXB2.0

Дополнительная Сводка Элемента

Дополнительные Элементы

Модификатор и Тип	Дополнительный Элемент и Описание
XmlNsForm	attributeFormDefault Квалификация пространства имен для атрибутов.
XmlNsForm	elementFormDefault Квалификация пространства имен для элементов.
Строка	расположение Указывает что это пространство имен (определенный namespace()) имеет схему, уже доступную экс-вечно, доступный в этом расположении.
Строка	пространство имен Имя пространства имен XML.
XmlNs[]	xmlns Настройте URI пространства имен, снабдите префиксом ассоциации.

Деталь элемента

xmlns

public abstract XmlNs[] xmlns

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

Значение по умолчанию:

{}

пространство имен

public abstract String namespace

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

Значение по умолчанию:

""

elementFormDefault

public abstract XmlNsForm elementFormDefault

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

Значение по умолчанию:

javax.xml.bind.annotation.XmlNsForm.UNSET

attributeFormDefault

public abstract XmlNsForm attributeFormDefault

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

Значение по умолчанию:

javax.xml.bind.annotation.XmlNsForm.UNSET

расположение

public abstract String location

Указывает что это пространство имен (определенный namespace()) имеет схему, уже доступную экс-вечно, доступный в этом расположении.

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

Эта функция предназначается, чтобы использоваться, когда ряд классов Java первоначально сгенерирован из существующей схемы, написанной от руки, чтобы соответствовать внешне определенную схему, или сгенерированная схема изменяется вручную.

Значение могло быть любым абсолютным URI, как http://example.org/some.xsd. Также возможно определить пустую строку, указать, что схема внешне доступна, но расположение является неуказанным (и таким образом это - ответственность читателя генерировать схемы, чтобы определить местоположение этого.) Наконец, значение по умолчанию этого свойства "##generate" указывает, что генератор схемы собирается генерировать компоненты для этого пространства имен (как это сделало в JAXB 2.0.)

Многократный XmlSchema аннотациям на многократные пакеты позволяют управлять тем же самым namespace(). В таком случае у всех их должно быть то же самое location() значения.

Отметьте конструктору

Более точно значением должен быть или "", "##generate", или допустимое лексическое представление xs:anyURI, который начинается с <scheme>:.

Генератор схемы, как ожидают, генерирует соответствующий <xs:import namespace="..." schemaLocation="..."/> (или никакой атрибут schemaLocation вообще, если пустая строка будет определена.) Однако, генератору схемы позволяют использовать различное значение в атрибуте schemaLocation (включая не генерирование такого атрибута), например так, чтобы пользователь мог определить локальную копию ресурса через интерфейс командной строки.

С тех пор:

JAXB2.1

Значение по умолчанию:

"##generate"