JavaTM 2 Platform
Standard Ed. 6

javax.xml.stream.events
接口 XMLEvent

所有超级接口:
XMLStreamConstants
所有已知子接口:
Attribute, Characters, Comment, DTD, EndDocument, EndElement, EntityDeclaration, EntityReference, Namespace, NotationDeclaration, ProcessingInstruction, StartDocument, StartElement

public interface XMLEvent
extends XMLStreamConstants

处理标记事件的基础事件接口。事件是用来与应用程序交流 XML 1.0 InfoSet 的 value 对象。可以在解析完事件之后缓存和引用事件。

从以下版本开始:
1.6
另请参见:
XMLEventReader, Characters, ProcessingInstruction, StartElement, EndElement, StartDocument, EndDocument, EntityReference, EntityDeclaration, NotationDeclaration

字段摘要
 
从接口 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
 
方法摘要
 Characters asCharacters()
          将此事件作为 Characters 返回,如果此事件不是字符,则可能导致类强制转化异常。
 EndElement asEndElement()
          将此事件作为结束元素事件返回,如果此事件不是结束元素,则可能导致类强制转换异常。
 StartElement asStartElement()
          将此事件作为开始元素事件返回,如果此事件不是开始元素,则可能导致类强制转换异常。
 int getEventType()
          返回此事件的整数码。
 Location getLocation()
          返回此事件的位置。
 QName getSchemaType()
          提供此方法是为了提供有关关联事件的可选类型信息。
 boolean isAttribute()
          检查此事件是否为 Attribute 的实用工具函数。
 boolean isCharacters()
          检查此事件是否为 Characters 的实用工具函数。
 boolean isEndDocument()
          检查此事件是否为 EndDocument 的实用工具函数。
 boolean isEndElement()
          检查此事件是否为 EndElement 的实用工具函数。
 boolean isEntityReference()
          检查此事件是否为 EntityReference 的实用工具函数。
 boolean isNamespace()
          检查此事件是否为 Namespace 的实用工具函数。
 boolean isProcessingInstruction()
          检查此事件是否为 ProcessingInstruction 的实用工具函数。
 boolean isStartDocument()
          检查此事件是否为 StartDocument 的实用工具函数。
 boolean isStartElement()
          检查此事件是否为 StartElement 的实用工具函数。
 void writeAsEncodedUnicode(Writer writer)
          此方法根据 XML 1.0 规范将 XMLEvent 编写为 Unicode 字符。
 

方法详细信息

getEventType

int getEventType()
返回此事件的整数码。

另请参见:
XMLStreamConstants.START_ELEMENT, XMLStreamConstants.END_ELEMENT, XMLStreamConstants.CHARACTERS, XMLStreamConstants.ATTRIBUTE, XMLStreamConstants.NAMESPACE, XMLStreamConstants.PROCESSING_INSTRUCTION, XMLStreamConstants.COMMENT, XMLStreamConstants.START_DOCUMENT, XMLStreamConstants.END_DOCUMENT, XMLStreamConstants.DTD

getLocation

Location getLocation()
返回此事件的位置。此方法返回的 Location 是不易改变的,将保留其信息。

另请参见:
Location

isStartElement

boolean isStartElement()
检查此事件是否为 StartElement 的实用工具函数。

另请参见:
StartElement

isAttribute

boolean isAttribute()
检查此事件是否为 Attribute 的实用工具函数。

另请参见:
Attribute

isNamespace

boolean isNamespace()
检查此事件是否为 Namespace 的实用工具函数。

另请参见:
Namespace

isEndElement

boolean isEndElement()
检查此事件是否为 EndElement 的实用工具函数。

另请参见:
EndElement

isEntityReference

boolean isEntityReference()
检查此事件是否为 EntityReference 的实用工具函数。

另请参见:
EntityReference

isProcessingInstruction

boolean isProcessingInstruction()
检查此事件是否为 ProcessingInstruction 的实用工具函数。

另请参见:
ProcessingInstruction

isCharacters

boolean isCharacters()
检查此事件是否为 Characters 的实用工具函数。

另请参见:
Characters

isStartDocument

boolean isStartDocument()
检查此事件是否为 StartDocument 的实用工具函数。

另请参见:
StartDocument

isEndDocument

boolean isEndDocument()
检查此事件是否为 EndDocument 的实用工具函数。

另请参见:
EndDocument

asStartElement

StartElement asStartElement()
将此事件作为开始元素事件返回,如果此事件不是开始元素,则可能导致类强制转换异常。


asEndElement

EndElement asEndElement()
将此事件作为结束元素事件返回,如果此事件不是结束元素,则可能导致类强制转换异常。


asCharacters

Characters asCharacters()
将此事件作为 Characters 返回,如果此事件不是字符,则可能导致类强制转化异常。


getSchemaType

QName getSchemaType()
提供此方法是为了提供有关关联事件的可选类型信息。信息是可选的,如果没有可用信息,则返回 null。


writeAsEncodedUnicode

void writeAsEncodedUnicode(Writer writer)
                           throws XMLStreamException
此方法根据 XML 1.0 规范将 XMLEvent 编写为 Unicode 字符。不应输出缩排或空格。 在将任何用户定义的事件类型写入输出流时,都应当调用此方法。内置 Event 类型必须实现此方法,但是在将内置 Event 写出到输出流时,为了优化目的,可以选择而不调用这些方法。生成的输出必须与所表示的信息集等效。

参数:
writer - 将输出数据的编写器
抛出:
XMLStreamException - 如果在写入事件时发生严重错误

JavaTM 2 Platform
Standard Ed. 6

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

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