Пакет javax.xml.bind.annotation

Определяет аннотации для того, чтобы настроить элементы программы Java к отображению XML-схемы.

См.: Описание

Интерфейсная Сводка

Интерфейс	Описание
DomHandler <ElementT, ResultT расширяет Результат>	Преобразовывает элемент (и его потомки) от ДОМА (или подобный) представление.

Сводка класса

Класс	Описание
W3CDomHandler	DomHandler реализация для W3C ДОМ (org.w3c.dom пакет.)
XmlElement. ЗНАЧЕНИЕ ПО УМОЛЧАНИЮ	Используемый в XmlElement.type() сигнализировать что тип быть выведенным из подписи свойства.
XmlElementDecl. ГЛОБАЛЬНАЯ ПЕРЕМЕННАЯ	Используемый в XmlElementDecl.scope() сигнализировать, что объявление находится в глобальной области видимости.
XmlElementRef. ЗНАЧЕНИЕ ПО УМОЛЧАНИЮ	Используемый в XmlElementRef.type() сигнализировать что тип быть выведенным из подписи свойства.
XmlSchemaType. ЗНАЧЕНИЕ ПО УМОЛЧАНИЮ	Используемый в XmlSchemaType.type() сигнализировать что тип быть выведенным из подписи свойства.
XmlType. ЗНАЧЕНИЕ ПО УМОЛЧАНИЮ	Используемый в XmlType.factoryClass() сигнализировать, что или фабрика mehod не используется или что это находится в классе с этим XmlType непосредственно.

Перечислимая Сводка

Перечисление	Описание
XmlAccessOrder	Используемый XmlAccessorOrder, чтобы управлять упорядочиванием свойств и полей в JAXB связанный класс.
XmlAccessType	Используемый XmlAccessorType, чтобы управлять сериализацией полей или свойств.
XmlNsForm	Перечисление квалификаций пространства имен XML Schema.

Аннотация Вводит Сводку

Тип аннотации	Описание
XmlAccessorOrder	Управляет упорядочиванием полей и свойств в классе.
XmlAccessorType	Средства управления или поля или свойства Javabean сериализируются по умолчанию.
XmlAnyAttribute	Отображает свойство JavaBean на карту подстановочных атрибутов.
XmlAnyElement	Отображает свойство JavaBean на представление инфонабора XML и/или элемент JAXB.
XmlAttachmentRef	Отмечает поле/свойство, что его форма XML является ссылкой туров, чтобы имитировать контент.
XmlAttribute	Отображает свойство JavaBean на атрибут XML.
XmlElement	Отображает свойство JavaBean на элемент XML, полученный из имени свойства.
XmlElementDecl	Отображает метод фабрики на элемент XML.
XmlElementRef	Отображает свойство JavaBean на элемент XML, полученный из типа свойства.
XmlElementRefs	Отмечает свойство, которое обращается к классам с XmlElement или JAXBElement.
XmlElements	Контейнер для многократногоXmlElement аннотации.
XmlElementWrapper	Генерирует элемент обертки вокруг представления XML.
XmlEnum	Отображает перечислимый тип Enum к представлению XML.
XmlEnumValue	Отображает перечислимую константу в Enum введите к представлению XML.
XmlID	Отображает свойство JavaBean на ID XML.
XmlIDREF	Отображает свойство JavaBean на XML IDREF.
XmlInlineBinaryData	Рассмотрение отключения XOP, кодирующего для типов данных, которые связываются с base64-закодированными двоичными данными в XML.
XmlList	Используемый, чтобы отобразить свойство на список простой тип.
XmlMimeType	Связывает тип MIME, который управляет представлением XML свойства.
XmlMixed	Аннотируйте JavaBean многозначное свойство, чтобы поддерживать смешанный контент.
XmlNs	Связывает префикс пространства имен с URI пространства имен XML.
XmlRegistry	Отмечает класс, который имеет XmlElementDecls.
XmlRootElement	Отображает класс или перечислимый тип к элементу XML.
XmlSchema	Отображает имя пакета к пространству имен XML.
XmlSchemaType	Отображает тип Java на простую схему встроенный тип.
XmlSchemaTypes	Контейнер для многократногоXmlSchemaType аннотации.
XmlSeeAlso	Дает JAXB команду также связывать другие классы, связывая этот класс.
XmlTransient	Предотвращает отображение свойства/типа JavaBean к представлению XML.
XmlType	Отображает класс или перечислимый тип к типу XML-схемы.
XmlValue	Включения, отображающие класс составного типа XML-схемы с simpleContent или XML-схемой простой тип.

Пакет javax.xml.bind.annotation Описание

Определяет аннотации для того, чтобы настроить элементы программы Java к отображению XML-схемы.

Спецификация пакета

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

Элемент программы	Аннотация JAXB
Пакет	XmlAccessorOrder XmlAccessorType XmlSchema XmlSchemaType XmlSchemaTypes XmlJavaTypeAdapter XmlJavaTypeAdapters
Класс	XmlAccessorOrder XmlAccessorType XmlInlineBinaryData XmlRootElement XmlType XmlJavaTypeAdapter
Перечислимый тип	XmlEnum XmlEnumValue (перечислимая константа только) XmlRootElement XmlType XmlJavaTypeAdapter
Свойство/поле JavaBean	XmlElement XmlElements XmlElementRef XmlElementRefs XmlElementWrapper XmlAnyElement XmlAttribute XmlAnyAttribute XmlTransient XmlValue XmlID XmlIDREF XmlList XmlMixed XmlMimeType XmlAttachmentRef XmlInlineBinaryData XmlElementDecl (только на методе) XmlJavaTypeAdapter
Параметр	XmlList XmlAttachmentRef XmlMimeType XmlJavaTypeAdapter

Терминология

Свойство JavaBean и поле: В целях отобразиться, нет никакого семантического различия между полем и свойством JavaBean. Таким образом аннотация, которая может быть применена к свойству JavaBean, может всегда применяться к полю. Следовательно в документации Javadoc, для краткости, свойства JavaBean термина или свойства используется, чтобы означать или свойство JavaBean или поле. Где требующийся, оба явно упоминаются.

высокоуровневый класс: С целью отображения нет никакого семантического различия между высокоуровневым классом и статическим вложенным классом. Таким образом аннотация, которая может быть применена к высокоуровневому классу, может всегда применяться к вложенному статическому классу. Следовательно в документации Javadoc, для краткости, термин "высокоуровневый класс" или только класс используется, чтобы означать или высокоуровневый класс или вложенный статический класс.

отображение annotation:A JAXB 2.0 определенных аннотации программы, основанные на JSR 175 средств аннотации программирования.

Ограничения Общего пользования

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

• Для свойства данная аннотация может быть применена или в чтение или в свойство записи, но не обоих.
• Имя свойства должно отличаться от любого другого имени свойства в любом из классов высшего качества отображаемого класса.
• Отображенное имя поля или decapitalized имя отображенного свойства должны быть уникальными в пределах класса.

Нотации

Префиксы пространства имен

Следующие префиксы пространства имен используются во фрагментах XML-схемы в этом пакете.

Префикс	Пространство имен	Примечания
xs	http://www.w3.org/2001/XMLSchema	Пространство имен пространства имен XML Schema
касательно	http://ws-i.org/profiles/basic/1.1/xsd	Пространство имен для swaref компонента схемы
xsi	http://www.w3.org/2001/XMLSchema-instance	Пространство имен XML Schema для экземпляров

С тех пор:

JAXB 2.0