javax.xml.bind
类 JAXBElement<T>

java.lang.Object
  javax.xml.bind.JAXBElement<T>

所有已实现的接口：

Serializable

public class JAXBElement<T>
extends Object
implements Serializable

Xml 元素的 JAXB 表示形式。

此类表示关于 Xml 元素的信息，这些信息包括模式中的元素声明，以及具有以下属性的 xml 文档中的元素实例值，如下所示：

• 元素的 xml 标记 name
• value 表示元素实例的属性和内容模式
• 元素声明的 declaredType（xs:element @type 属性）
• 元素声明的 scope
• boolean 值形式的 nil 属性。（元素实例的 xsi:nil 属性）

declaredType 和 scope 属性是 xml 类型定义的 JAXB 类绑定。

Scope 可以是 JAXBElement.GlobalScope，也可以是表示包含模式元素声明的复杂类型定义的 Java 类。

这里有一个属性约束，即如果 value 为 null，则 nil 一定为 true。反之则不然，以支持表示包含属性的 nil 元素。如果 nil 为 true，则 value 可能为非 null，这样它可以保存与 nil 元素关联的属性值。

从以下版本开始：

JAXB 2.0

另请参见：

序列化表格

name

protected final QName name

xml 元素标记名称。

declaredType

protected final Class<T> declaredType

xml 元素声明类型的 Java 数据类型绑定。

scope

protected final Class scope

表示此 xml 元素实例的 xml 元素声明的作用域。可以是以下值之一：全局 xml 元素声明的 JAXBElement.GlobalScope。局部元素声明有一个被设置为包含 xml 元素声明的复杂类型定义的 Java 类表示形式的作用域。

value

protected T value

xml 元素值。表示 xml 元素实例的内容模式和属性。

nil

protected boolean nil

如果 xml 元素实例具有 xsi:nil="true" 属性，则 nil 为 true。

JAXBElement

public JAXBElement(QName name,
                   Class<T> declaredType,
                   Class scope,
                   T value)

构造一个 xml 元素实例。

参数：

name - xml 元素标记名称的 Java 绑定

declaredType - xml 元素声明类型的 Java 绑定

scope - xml 元素声明作用域的 Java 绑定。传递 null 与传递 GlobalScope.class 相同

value - 表示 xml 元素值的 Java 实例。

另请参见：

getScope(), isTypeSubstituted()

JAXBElement

public JAXBElement(QName name,
                   Class<T> declaredType,
                   T value)

构造一个 xml 元素实例。这只是 new JAXBElement(name,declaredType,GlobalScope.class,value) 的一个便捷方法。

getDeclaredType

public Class<T> getDeclaredType()

返回 xml 元素声明的类型属性的 Java 绑定。

getName

public QName getName()

返回 xml 元素标记名称。

setValue

public void setValue(T t)

设置此 xml 元素的内容模式和属性。

在将此属性设置为 null 时，isNil() 一定为 true。在 isNil() 中描述了约束的详细信息。

另请参见：

isTypeSubstituted()

getValue

public T getValue()

返回此元素的内容模式和属性值。

关于此值为 null 时的属性约束的描述，请参见 isNil()。

getScope

public Class getScope()

返回 xml 元素声明的作用域。

返回：

如果此元素位于全局作用域中，则返回 GlobalScope.class。

另请参见：

isGlobalScope()

isNil

public boolean isNil()

如果此元素实例内容模式为 nil，则返回 true。

当 getValue() 为 null 时，此属性总是返回 true。注意，反之则不然，当此属性为 true 时，getValue() 可以包含非 null 属性值。对于 nil xml 元素，包含属性是有效的。

setNil

public void setNil(boolean value)

设置此属性是否包含 nil 内容。

另请参见：

isNil()

isGlobalScope

public boolean isGlobalScope()

如果此 xml 元素声明是全局性的，则返回 true。

isTypeSubstituted

public boolean isTypeSubstituted()

如果此 xml 元素实例的值的类型与 xml 元素声明的声明类型不同，则返回 true。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。