javax.xml.transform.stax
类 StAXSource

java.lang.Object
  javax.xml.transform.stax.StAXSource

所有已实现的接口：

Source

public class StAXSource
     

      extends 
      Object
     
     

      implements 
      Source
     

以 StAX reader 的形式（即 XMLStreamReader 或 XMLEventReader）充当 XML Source 的持有者。各种接受 Source 的情况下都可以使用 StAXSource，例如，将 Source 作为输入接受的 Transformer 和 Validator。

在处理期间使用 StAXSource 并且不能重复使用。

从以下版本开始：

1.6

另请参见：

JSR 173:Streaming API for XML, XMLStreamReader, XMLEventReader

FEATURE

public static final String FEATURE

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

另请参见：

常量字段值

StAXSource

public StAXSource(XMLEventReader xmlEventReader)
           throws XMLStreamException

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

XMLEventReader 必须为非 null 引用。

XMLEventReader 必须处于 XMLStreamConstants.START_DOCUMENT 或 XMLStreamConstants.START_ELEMENT 状态。

参数：

xmlEventReader - 用于创建此 StAXSource 的 XMLEventReader。

抛出：

XMLStreamException - 如果 xmlEventReader 访问抛出 Exception。

IllegalArgumentException - 如果 xmlEventReader == null。

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

StAXSource

public StAXSource(XMLStreamReader xmlStreamReader)

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

XMLStreamReader 必须为非 null 引用。

XMLStreamReader 必须处于 XMLStreamConstants.START_DOCUMENT 或 XMLStreamConstants.START_ELEMENT 状态。

参数：

xmlStreamReader - 用于创建此 StAXSource 的 XMLStreamReader。

抛出：

IllegalArgumentException - 如果 xmlStreamReader == null。

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

getXMLEventReader

public XMLEventReader getXMLEventReader()

获取此 StAXSource 使用的 XMLEventReader。

如果此 StAXSource 是使用 XMLStreamReader 创建的，那么 XMLEventReader 将为 null。

返回：

此 StAXSource 使用的 XMLEventReader。

getXMLStreamReader

public XMLStreamReader getXMLStreamReader()

获取此 StAXSource 使用的 XMLStreamReader。

如果此 StAXSource 是使用 XMLEventReader 创建的，那么 XMLStreamReader 将为 null。

返回：

此 StAXSource 使用的 XMLStreamReader。

setSystemId

public void setSystemId(String systemId)

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

此方法始终抛出 UnsupportedOperationException。

指定者：

接口 Source 中的 setSystemId

参数：

systemId - 忽略。

抛出：

UnsupportedOperationException - 此方法 始终抛出该异常。

getSystemId

public String getSystemId()

获取此 StAXSource 使用的系统标识符。

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

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

指定者：

接口 Source 中的 getSystemId

返回：

此 StAXSource 使用的系统标识符。