След: Архитектура Java для XML, Связывающего (JAXB)
Урок: Введение в JAXB
Настройка Сгенерированных Классов и Элементов Программы Java
Домашняя страница > Архитектура Java для XML, Связывающего (JAXB) > Введение в JAXB

Настройка Сгенерированных Классов и Элементов Программы Java

Следующие разделы описывают, как настроить сгенерированные классы JAXB и элементы программы Java.

Схема к Java

Пользовательские JAXB обязательные объявления позволяют Вам настроить свои сгенерированные классы JAXB вне специфичных для XML ограничений в XML-схеме, чтобы включать специфичные для Java усовершенствования, такие как class и отображения имени пакета.

JAXB обеспечивает два способа настроить XML-схему:

Примеры кода, которые показывают, как настроить привязку JAXB, обеспечиваются позже в этом документе.

Java к схеме

Аннотации JAXB, определенные в пакете javax.xml.bind.annotation, могут использоваться, чтобы настроить элементы программы Java к отображению XML-схемы. Следующая таблица суммирует аннотации JAXB, которые могут использоваться с пакетом Java.

Таблица: Аннотации JAXB, Связанные с Пакетом Java

Аннотация Описание и Настройка по умолчанию
@XmlSchema Отображает пакет на целевое пространство имен XML.
Настройки по умолчанию:
@XmlSchema ( 
    xmlns = {}, 
    namespace = "", 
    elementFormDefault = XmlNsForm.UNSET, 
    attributeFormDefault = XmlNsForm.UNSET
)
@XmlAccessorType Сериализация значения по умолчанию средств управления полей и свойств.
Настройки по умолчанию:
@XmlAccessorType (
    value = AccessType.PUBLIC_MEMBER 
)
@XmlAccessorOrder Управляет упорядочиванием значения по умолчанию свойств и полей, отображенных на элементы XML.
Настройки по умолчанию:
@XmlAccessorOrder (
    value = AccessorOrder.UNDEFINED
)
@XmlSchemaType Позволяет специализированное отображение на XML-схему встроенный тип.
Настройки по умолчанию:
@XmlSchemaType (
    namespace = 
    "http://www.w3.org/2001/XMLSchema", 
    type = DEFAULT.class
)
@XmlSchemaTypes Контейнерная аннотация для того, чтобы определить многократные аннотации @XmlSchemaType.
Значение по умолчанию settings:None


Следующая таблица суммирует аннотации JAXB, которые могут использоваться с Java class.

Таблица: Аннотации JAXB, Связанные с Классом Java

Аннотация Описание и Настройка по умолчанию
@XmlType Отображает Java class на тип схемы.
Настройки по умолчанию:
@XmlType (
    name = "##default", 
    propOrder = {""}, 
    namespace = "##default", 
    factoryClass = DEFAULT.class, 
    factoryMethod = ""
)
@XmlRootElement Связывает глобальный элемент с типом схемы, на который отображается class.
Настройки по умолчанию:
@XmlRootElement (
    name = "##default", 
    namespace = "##default" 
)

Следующая таблица суммирует аннотации JAXB, которые могут использоваться с Java тип enum.

Таблица: Аннотации JAXB, Связанные с Java Тип enum

Аннотация Описание и Настройка по умолчанию
@XmlEnum Отображает тип Java на XML простой тип.
Настройки по умолчанию:
@XmlEnum ( value = String.class )
@XmlEnumValue Отображает тип Java на XML простой тип.
Значение по умолчанию settings:None
@XmlType Отображает Java class на тип схемы.
Настройки по умолчанию:
 
@XmlType (
    name = "##default", 
    propOrder = {""}, 
    namespace = "##default", 
    factoryClass = DEFAULT.class, 
    factoryMethod = ""
)
@XmlRootElement Связывает глобальный элемент с типом схемы, на который отображается class.
Настройки по умолчанию:
@XmlRootElement (
    name = "##default", 
    namespace = "##default" 
)


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

Таблица: Аннотации JAXB, Связанные со Свойствами Java и Полями

Аннотация Описание и Настройка по умолчанию
@XmlElement Отображает свойство JavaBeans или поле к элементу XML, полученному из свойства или имени поля.
Настройки по умолчанию:
@XmlElement (
    name = "##default", 
    nillable = false, 
    namespace = "##default", 
    type = DEFAULT.class, 
    defaultValue = "\u0000"
)
@XmlElements Контейнерная аннотация для того, чтобы определить многократные аннотации @XmlElement.
Значение по умолчанию settings:None
@XmlElementRef Отображает свойство JavaBeans или поле к элементу XML, полученному из типа поля или свойства.
Настройки по умолчанию:
@XmlElementRef (
    name = "##default", 
    namespace = "##default", 
    type = DEFAULT.class
)
@XmlElementRefs Контейнерная аннотация для того, чтобы определить многократные аннотации @XmlElementRef.
Значение по умолчанию settings:None
@XmlElementWrapper Генерирует элемент обертки вокруг представления XML. Это обычно используется в качестве элемента XML обертки вокруг наборов.
Настройки по умолчанию:
@XmlElementWrapper (
    name = "##default", 
    namespace = "##default", 
    nillable = false
)
@XmlAnyElement Отображает свойство JavaBeans на представление инфонабора XML или элемент JAXB.
Настройки по умолчанию:
@XmlAnyElement (
    lax = false, 
    value = W3CDomHandler.class
)
@XmlAttribute Отображает свойство JavaBeans на атрибут XML.
Настройки по умолчанию:
@XmlAttribute (
    name = ##default, 
    required = false, 
    namespace = "##default" 
)
@XmlAnyAttribute Отображает свойство JavaBeans на карту подстановочных атрибутов.
Значение по умолчанию settings:None
@XmlTransient Предотвращает отображение свойства JavaBeans к представлению XML.
Значение по умолчанию settings:None
@XmlValue Определяет отображение class к составному типу XML-схемы с simpleContent или XML-схемой простой тип.
Значение по умолчанию settings:None
@XmlID Отображает свойство JavaBeans на ID XML.
Значение по умолчанию settings:None
@XmlIDREF Отображает свойство JavaBeans на XML IDREF.
Значение по умолчанию settings:None
@XmlList Отображает свойство на список простой тип.
Значение по умолчанию settings:None
@XmlMixed Отмечает JavaBeans многозначное свойство, чтобы поддерживать смешанный контент.
Значение по умолчанию settings:None
@XmlMimeType Связывает тип MIME, который управляет представлением XML свойства.
Значение по умолчанию settings:None
@XmlAttachmentRef Отмечает поле/свойство, что его форма XML является ссылкой URI, чтобы имитировать контент.
Значение по умолчанию settings:None
@XmlInlineBinaryData Отключает рассмотрение XOP, кодирующего для типов данных, которые связываются с base64-закодированными двоичными данными в XML.
Значение по умолчанию settings:None


Следующая таблица суммирует аннотацию JAXB, которая может использоваться с объектными фабриками.

Таблица: Аннотации JAXB, Связанные с Объектными Фабриками

Аннотация Описание и Настройка по умолчанию
@XmlElementDecl Отображает метод фабрики на элемент XML.
Настройки по умолчанию:
@XmlElementDecl (
    scope = GLOBAL.class, 
    namespace = "##default", 
    substitutionHeadNamespace = "##default", 
    substitutionHeadName = ""
)


Следующая таблица суммирует аннотации JAXB, которые могут использоваться с адаптерами.

Таблица: Аннотации JAXB, Связанные с Адаптерами

Аннотация Описание и Настройка по умолчанию
@XmlJavaTypeAdapter Используйте адаптер, который реализует аннотацию @XmlAdapter для пользовательского маршалинга.
Настройки по умолчанию:
@XmlJavaTypeAdapter ( type = DEFAULT.class )
@XmlJavaTypeAdapters Контейнерная аннотация для того, чтобы определить многократные аннотации @XmlJavaTypeAdapter на уровне пакета.
Настройки по умолчанию: Ни один



Проблемы с примерами? Попытайтесь Компилировать и Выполнить Примеры: FAQ.
Жалобы? Поздравление? Предложения? Дайте нам свою обратную связь.

Предыдущая страница: Привязка XML-схем
Следующая страница: Примеры JAXB



Spec-Zone.ru - all specs in one place