XmlElementRefs (Java EE 5)

Java EE API

previous page next page

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: REQUIRED | OPTIONAL

DETAIL: ELEMENT

javax.xml.bind.annotation Annotation Type XmlElementRefs

@Retention(value=RUNTIME) @Target(value={FIELD,METHOD}) public @interface XmlElementRefs

Implements: Annotation

@Retention(value=RUNTIME)
@Target(value={FIELD, METHOD})

标记一个属性，该属性引用带有 XmlElement 或 JAXBElement 的类。

与元素属性（带有 XmlElement 注释的属性）比较，引用属性具有不同的替换语义。在将子类分配给属性时，元素属性将生成带有 @xsi:type 的相同标记名称，而引用属性则生成一个不同的标记名称（子类上的标记名称）。

此注释可与下列注释一起使用：XmlJavaTypeAdapter 和 XmlElementWrapper。

since	JAXB2.0
See also	javax.xml.bind.annotation.XmlElementWrapper, javax.xml.bind.annotation.XmlElementRef

英文文档：

Marks a property that refers to classes with XmlElement or JAXBElement.

Compared to an element property (property with XmlElement annotation), a reference property has a different substitution semantics. When a sub-class is assigned to a property, an element property produces the same tag name with @xsi:type, whereas a reference property produces a different tag name (the tag name that's on the the sub-class.)

This annotation can be used with the following annotations: XmlJavaTypeAdapter, XmlElementWrapper.

Since:

JAXB2.0

Author: