compact2, compact3

javax.xml.stream.events

Interface XMLEvent

All Superinterfaces:

XMLStreamConstants

All Known Subinterfaces:

Attribute， Characters， Comment， DTD， EndDocument， EndElement， EntityDeclaration， EntityReference， Namespace， NotationDeclaration， ProcessingInstruction， StartDocument， StartElement

public interface XMLEvent
extends XMLStreamConstants

这是处理标记事件的基本事件接口。事件是用来沟通的XML 1集的应用价值对象。在解析完成后，事件可能被缓存和引用。

从以下版本开始：

一点六

Version:

一

另请参见：

XMLEventReader， Characters， ProcessingInstruction， StartElement， EndElement， StartDocument， EndDocument， EntityReference， EntityDeclaration， NotationDeclaration

Field Summary

Fields inherited from interface 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

方法摘要

Modifier and Type	Method and Description
Characters	asCharacters() 如果此事件为字符，则返回此事件为字符，如果此事件不是字符，则可能导致类转换异常。
EndElement	asEndElement() 如果此事件不是结束元素，则返回此事件作为结束元素事件，可能会导致类转换异常。
StartElement	asStartElement() 如果此事件不是开始元素，则返回此事件作为开始元素事件，可能会导致类转换异常。
int	getEventType() 返回此事件的整数代码。
Location	getLocation() 返回此事件的位置。
QName	getSchemaType() 提供此方法以提供有关关联事件的可选类型信息的实现方法。
boolean	isAttribute() 检查此事件是否是属性的一个实用工具。
boolean	isCharacters() 检查此事件是否是字符的实用程序功能。
boolean	isEndDocument() 效用函数来检查这个事件是一个专件。
boolean	isEndElement() 效用函数来检查这个事件是一个EndElement。
boolean	isEntityReference() 效用函数来检查这一事件是EntityReference。
boolean	isNamespace() 检查此事件是否是命名空间的一个实用函数。
boolean	isProcessingInstruction() 效用函数来检查这个事件是一个ProcessingInstruction。
boolean	isStartDocument() 效用函数来检查这个事件是StartDocument。
boolean	isStartElement() 效用函数来检查这个事件是一个不同。
void	writeAsEncodedUnicode(Writer writer) 该方法将写XMLEvent按XML 1规范的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

isStartElement

boolean isStartElement()

效用函数来检查这个事件是一个不同。

另请参见：

StartElement

isAttribute

boolean isAttribute()

检查此事件是否是属性的一个实用工具。

另请参见：

Attribute

isNamespace

boolean isNamespace()

检查此事件是否是命名空间的一个实用函数。

另请参见：

Namespace

isEndElement

boolean isEndElement()

效用函数来检查这个事件是一个EndElement。

另请参见：

EndElement

isEntityReference

boolean isEntityReference()

效用函数来检查这一事件是EntityReference。

另请参见：

EntityReference

isProcessingInstruction

boolean isProcessingInstruction()

效用函数来检查这个事件是一个ProcessingInstruction。

另请参见：

ProcessingInstruction

isCharacters

boolean isCharacters()

检查此事件是否是字符的实用程序功能。

另请参见：

Characters

isStartDocument

boolean isStartDocument()

效用函数来检查这个事件是StartDocument。

另请参见：

StartDocument

isEndDocument

boolean isEndDocument()

效用函数来检查这个事件是一个专件。

另请参见：

EndDocument

asStartElement

StartElement asStartElement()

如果此事件不是开始元素，则返回此事件作为开始元素事件，可能会导致类转换异常。

asEndElement

EndElement asEndElement()

如果此事件不是结束元素，则返回此事件作为结束元素事件，可能会导致类转换异常。

asCharacters

Characters asCharacters()

如果此事件为字符，则返回此事件为字符，如果此事件不是字符，则可能导致类转换异常。

getSchemaType

QName getSchemaType()

提供此方法以提供有关关联事件的可选类型信息的实现方法。它是可选的，如果没有可用的信息，将返回空值。

writeAsEncodedUnicode

void writeAsEncodedUnicode(Writer writer)
                    throws XMLStreamException

该方法将写XMLEvent按XML 1规范的Unicode字符。无压痕或空白应该输出。当写入到输出流时，任何用户定义的事件类型都将有这种方法调用。内置的事件类型必须实现此方法，但在将事件写入到输出流中时，可以选择不调用这些方法进行优化的原因。产生的输出必须在各方面相当的表达。

参数

writer的作家，将输出数据

异常

XMLStreamException -如果有一个致命的错误，如写作