Spec-Zone .ru спецификации, руководства, описания, API

Пакет 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 не используется или что это находится в class с этим XmlType непосредственно.

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

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

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

XmlAccessorOrder	Управляет упорядочиванием полей и свойств в class.
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	Отмечает class, который имеет XmlElementDecls.
XmlRootElement	Отображает class или перечислимый тип к элементу XML.
XmlSchema	Отображает имя пакета к пространству имен XML.
XmlSchemaType	Отображает тип Java на простую схему встроенный тип.
XmlSchemaTypes	Контейнер для многократногоXmlSchemaType аннотации.
XmlSeeAlso	Дает JAXB команду также связывать другие классы, связывая этот class.
XmlTransient	Предотвращает отображение свойства/типа JavaBean к представлению XML.
XmlType	Отображает class или перечислимый тип к типу XML-схемы.
XmlValue	Позволяет отобразить class на составной тип 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 или поле. Где требующийся, оба явно упоминаются.

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

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

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

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

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

Нотации

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

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

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

С тех пор:

JAXB 2.0