javax.xml.stream.events
接口 StartElement

所有超级接口：

XMLEvent, XMLStreamConstants

public interface StartElement
extends XMLEvent

StartElement 接口提供对有关开始元素的信息的访问。StartElement 报告文档中的每个开始标记。

从以下版本开始：

1.6

getName

QName getName()

获取此事件的名称

返回：

此事件的限定名

getAttributes

Iterator getAttributes()

返回在此 START_ELEMENT 上声明的已声明非名称空间属性的 Iterator；如果没有这样的属性，则返回空迭代器。迭代器必须只包含 javax.xml.stream.Attribute 接口的实现。属性是完全无序的，且不能以任意顺序报告。

返回：

可在 Attribute 接口上进行迭代的只读 Iterator，或者返回空迭代器

getNamespaces

Iterator getNamespaces()

返回在此元素上声明的名称空间的 Iterator。此 Iterator 不包含以前声明的名称空间，除非它们出现在当前 START_ELEMENT 中。因此该列表可能包含重新声明的名称空间和重复的名称空间声明。使用 getNamespaceContext() 方法获取名称空间声明的当前上下文。

迭代器只能包含 javax.xml.stream.Namespace 接口的实现。

名称空间是一个属性。可以以属性列表的方式在名称空间列表上进行迭代。但是，此方法只返回在此 START_ELEMENT 中声明的名称空间的列表，不包含在此 START_ELEMENT 中声明的属性。 如果没有名称空间，则返回空迭代器。

返回：

可在名称空间接口上进行迭代的只读 Iterator，或者返回空迭代器

getAttributeByName

Attribute getAttributeByName(QName name)

返回此名称引用的属性

参数：

name - 所需名称的 qname

返回：

与名称值相对应的属性或 null

getNamespaceContext

NamespaceContext getNamespaceContext()

获取只读名称空间上下文。如果没有可用的上下文，此方法将返回空名称空间上下文。NamespaceContext 包含有关此 StartElement 的作用域中所有名称空间的信息。

返回：

当前名称空间上下文

getNamespaceURI

String getNamespaceURI(String prefix)

获取绑定在此元素上下文中的前缀的值。如果前缀未绑定在此上下文中，则返回 null

参数：

prefix - 要查找的前缀

返回：

绑定到前缀的 URI 或 null

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