JavaTM Platform
Standard Ed. 6

javax.xml.stream.events
接口 StartElement

所有超级接口:
XMLEvent, XMLStreamConstants

public interface StartElement
extends XMLEvent

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

从以下版本开始:
1.6

字段摘要
 
从接口 javax.xml.stream.XMLStreamConstants 继承的字段
ATTRIBUTE, CDATA, CHARACTERS, COMMENT, DTD, END_DOCUMENT, END_ELEMENT, ENTITY_DECLARATION, ENTITY_REFERENCE, NAMESPACE, NOTATION_DECLARATION, PROCESSING_INSTRUCTION, SPACE, START_DOCUMENT, START_ELEMENT
 
方法摘要
 Attribute getAttributeByName(QName name)
          返回此名称引用的属性
 Iterator getAttributes()
          返回在此 START_ELEMENT 上声明的已声明非名称空间属性的 Iterator;如果没有这样的属性,则返回空迭代器。
 QName getName()
          获取此事件的名称
 NamespaceContext getNamespaceContext()
          获取只读名称空间上下文。
 Iterator getNamespaces()
          返回在此元素上声明的名称空间的 Iterator。
 String getNamespaceURI(String prefix)
          获取绑定在此元素上下文中的前缀的值。
 
从接口 javax.xml.stream.events.XMLEvent 继承的方法
asCharacters, asEndElement, asStartElement, getEventType, getLocation, getSchemaType, isAttribute, isCharacters, isEndDocument, isEndElement, isEntityReference, isNamespace, isProcessingInstruction, isStartDocument, isStartElement, writeAsEncodedUnicode
 

方法详细信息

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

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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