Spec-Zone .ru
спецификации, руководства, описания, API
|
|
Spec-Zone .ru
спецификации, руководства, описания, API
|
Следующие разделы описывают, как настроить сгенерированные классы JAXB и элементы программы Java.
Пользовательские JAXB обязательные объявления позволяют Вам настроить свои сгенерированные классы JAXB вне специфичных для XML ограничений в XML-схеме, чтобы включать специфичные для Java усовершенствования, такие как class и отображения имени пакета.
JAXB обеспечивает два способа настроить XML-схему:
Примеры кода, которые показывают, как настроить привязку JAXB, обеспечиваются позже в этом документе.
Аннотации 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
| Аннотация | Описание и Настройка по умолчанию |
|---|---|
| @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 и Полями
| Аннотация | Описание и Настройка по умолчанию |
|---|---|
| @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, Связанные с Объектными Фабриками
| Аннотация | Описание и Настройка по умолчанию |
|---|---|
| @XmlElementDecl | Отображает метод фабрики на элемент XML. Настройки по умолчанию:
@XmlElementDecl (
scope = GLOBAL.class,
namespace = "##default",
substitutionHeadNamespace = "##default",
substitutionHeadName = ""
)
|
Таблица: Аннотации JAXB, Связанные с Адаптерами
| Аннотация | Описание и Настройка по умолчанию |
|---|---|
| @XmlJavaTypeAdapter | Используйте адаптер, который реализует аннотацию @XmlAdapter для пользовательского маршалинга. Настройки по умолчанию: @XmlJavaTypeAdapter ( type = DEFAULT.class ) |
| @XmlJavaTypeAdapters | Контейнерная аннотация для того, чтобы определить многократные аннотации @XmlJavaTypeAdapter на уровне пакета. Настройки по умолчанию: Ни один |
|
