compact2, compact3

javax.xml.transform.stax

Class StAXSource

java.lang.Object

javax.xml.transform.stax.StAXSource

All Implemented Interfaces:

Source

public class StAXSource
extends Object
implements Source

作为StAX阅读器形式的XML Source的持有人，即XMLStreamReader或XMLEventReader 。 StAXSource可以在接受所有情况下使用Source ，例如Transformer ， Validator ，其接受Source作为输入。

StAXSource在处理过程中消耗，不可重复使用。

从以下版本开始：

1.6

另请参见：

JSR 173: Streaming API for XML ， XMLStreamReader ， XMLEventReader

Field Summary

Fields

Modifier and Type	Field and Description
static String	FEATURE 如果 TransformerFactory.getFeature(String name)将该值作为参数传递时返回true，则Transformer支持此类型的Source输入。

构造方法摘要

构造方法

Constructor and Description
StAXSource(XMLEventReader xmlEventReader) 创建的新实例StAXSource通过提供一个XMLEventReader 。
StAXSource(XMLStreamReader xmlStreamReader) 创建的新实例StAXSource通过提供一个XMLStreamReader 。

方法摘要

Modifier and Type	Method and Description
String	getSystemId() 获取此StAXSource使用的系统 StAXSource 。
XMLEventReader	getXMLEventReader() 获取此 XMLEventReader使用的 StAXSource 。
XMLStreamReader	getXMLStreamReader() 获取此 XMLStreamReader使用的 StAXSource 。
void	setSystemId(String systemId) 在 StAXSource的上下文中，显式设置系统标识符是不合适的。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

FEATURE

public static final String FEATURE

如果 TransformerFactory.getFeature(String name)将该值作为参数传递时返回true，则Transformer支持此类型的Source输入。

另请参见：

Constant Field Values

构造方法详细信息

StAXSource

public StAXSource(XMLEventReader xmlEventReader)
           throws XMLStreamException

创建的新实例StAXSource通过提供一个XMLEventReader 。

XMLEventReader必须是非null参考。

XMLEventReader必须在XMLStreamConstants.START_DOCUMENT或XMLStreamConstants.START_ELEMENT状态。

参数

xmlEventReader - XMLEventReader用于创建此 StAXSource 。

异常

XMLStreamException - 如果 xmlEventReader访问 异常了一个 异常 。

IllegalArgumentException - 如果 xmlEventReader == null 。

IllegalStateException - 如果 xmlEventReader不在 XMLStreamConstants.START_DOCUMENT或 XMLStreamConstants.START_ELEMENT状态。

StAXSource

public StAXSource(XMLStreamReader xmlStreamReader)

创建的新实例StAXSource通过提供一个XMLStreamReader 。

XMLStreamReader必须是非null参考。

XMLStreamReader必须在XMLStreamConstants.START_DOCUMENT或XMLStreamConstants.START_ELEMENT状态。

参数

xmlStreamReader - XMLStreamReader用于创建此 StAXSource 。

异常

IllegalArgumentException - 如果 xmlStreamReader == null 。

IllegalStateException - 如果 xmlStreamReader不在 XMLStreamConstants.START_DOCUMENT或 XMLStreamConstants.START_ELEMENT状态。

方法详细信息

getXMLEventReader

public XMLEventReader getXMLEventReader()

获取此XMLEventReader使用的StAXSource 。

XMLEventReader将会是null 。 如果这个StAXSource是用XMLStreamReader创建的。

结果

XMLEventReader被这个 StAXSource 。

getXMLStreamReader

public XMLStreamReader getXMLStreamReader()

获取此XMLStreamReader使用的StAXSource 。

XMLStreamReader将是null如果这StAXSource是用XMLEventReader创建的。

结果

XMLStreamReader被这个 StAXSource 。

setSystemId

public void setSystemId(String systemId)

在StAXSource的上下文中，显式设置系统标识符是不合适的。 用于构造此StAXSource的XMLStreamReader或XMLEventReader确定了XML源的系统标识符。

这个方法总是抛出一个UnsupportedOperationException 。

Specified by:

setSystemId在界面 Source

参数

systemId - 忽略。

异常

UnsupportedOperationException - 总是被这个方法抛出。

getSystemId

public String getSystemId()

获取此StAXSource使用的系统StAXSource 。

用于构建此StAXSource的XMLStreamReader或XMLEventReader进行查询以确定XML源的系统标识符。

系统标识符可以是null或空的"" String 。

Specified by:

getSystemId在接口 Source

结果

该 StAXSource使用的系统 StAXSource 。