|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 必需 | 可选 | 详细信息: 元素 |
@Retention(value=RUNTIME) @Target(value={FIELD,METHOD}) public @interface XmlElement
将 JavaBean 属性映射到派生于属性名称的 XML 元素。
用法
@XmlElement 注释可以与以下程序元素一起使用:
XmlElements
中的程序元素
XmlID
、XmlIDREF
、XmlList
、XmlSchemaType
、XmlValue
、XmlAttachmentRef
、XmlMimeType
、XmlInlineBinaryData
、XmlElementWrapper
和 XmlJavaTypeAdapter
。XmlElements
一起使用,那么 @XmlElement.type() 在集合条目类型已知的情况下必须是 DEFAULT.class。 在使用 @XmlElement 注释进行注释时,JavaBean 属性被映射到 XML 模式复杂类型中的本地元素,包含的类被映射到此 XML 模式复杂类型。
示例 1:将 public 非 static 非 final 字段映射到本地元素。
//Example: Code fragment public class USPrice { @XmlElement(name="itemprice") public java.math.BigDecimal price; } <!-- Example: Local XML Schema element --> <xs:complexType name="USPrice"/> <xs:sequence> <xs:element name="itemprice" type="xs:decimal" minOccurs="0"/> </sequence> </xs:complexType>
示例 2:将字段映射到 nillable 元素。
//Example: Code fragment public class USPrice { @XmlElement(nillable=true) public java.math.BigDecimal price; } <!-- Example: Local XML Schema element --> <xs:complexType name="USPrice"> <xs:sequence> <xs:element name="price" type="xs:decimal" nillable="true" minOccurs="0"/> </sequence> </xs:complexType>
示例 3: 将字段映射到 nillable、required 元素。
//Example: Code fragment public class USPrice { @XmlElement(nillable=true, required=true) public java.math.BigDecimal price; } <!-- Example: Local XML Schema element --> <xs:complexType name="USPrice"> <xs:sequence> <xs:element name="price" type="xs:decimal" nillable="true" minOccurs="1"/> </sequence> </xs:complexType>
示例 4:将 JavaBean 属性映射到具有匿名类型的 XML 元素。
请参阅 @XmlType
中的示例 6。
可选元素摘要 | |
---|---|
String |
defaultValue
此元素的默认值。 |
String |
name
XML 模式元素的名称。 |
String |
namespace
XML 模式元素的 XML 目标名称空间。 |
boolean |
nillable
将元素声明自定义为 nillable。 |
boolean |
required
自定义所需的元素声明。 |
Class |
type
正被引用的 Java 类。 |
public abstract String name
如果值为 "##default",那么元素名称派生于 JavaBean 属性名称。
public abstract boolean nillable
如果 nillable() 为 true,那么 JavaBean 属性被映射到 XML 模式 nillable 元素声明。
public abstract boolean required
如果 required() 为 true,则将 Javabean 属性映射到一个 minOccurs="1" 的 XML 模式元素声明。maxOccurs 为 "1" 表示单个赋值的属性,maxOccurs 为 "unbounded" 则表示多个赋值的属性。
如果 required() 为 false,则将 Javabean 属性映射到一个 minOccurs="0" 的 XML 模式元素声明。maxOccurs 为 "1" 表示单个赋值的属性,maxOccurs 为 "unbounded" 则表示多个赋值的属性。
public abstract String namespace
如果该值为 "##default",则名称空间通过以下方式确定:
XmlSchema
注释,并且其 elementFormDefault
为 QUALIFIED
,则名称空间为封闭类的名称空间。
public abstract String defaultValue
作为此注释元素的默认值指定的 '' 值被用作 null 的替代,从而允许识别 'no default value' 状态。
public abstract Class type
|
JavaTM Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 必需 | 可选 | 详细信息: 元素 |
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。