JavaTM Platform
Standard Ed. 6

javax.xml.transform.stax
类 StAXSource

java.lang.Object
  继承者 javax.xml.transform.stax.StAXSource
所有已实现的接口:
Source

public class StAXSource
extends Object
implements Source

以 StAX reader 的形式(即 XMLStreamReaderXMLEventReader)充当 XML Source 的持有者。各种接受 Source 的情况下都可以使用 StAXSource,例如,将 Source 作为输入接受的 TransformerValidator

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

从以下版本开始:
1.6
另请参见:
JSR 173:Streaming API for XML, XMLStreamReader, XMLEventReader

字段摘要
static String FEATURE
          当将此值作为参数传递时,如果 TransformerFactory.getFeature(String name) 返回 true,则 Transformer 支持此类型的 Source 输入。
 
构造方法摘要
StAXSource(XMLEventReader xmlEventReader)
          通过提供 XMLEventReader 创建 StAXSource 的一个新实例。
StAXSource(XMLStreamReader xmlStreamReader)
          通过 XMLStreamReader 创建 StAXSource 的一个新实例。
 
方法摘要
 String getSystemId()
          获取此 StAXSource 使用的系统标识符。
 XMLEventReader getXMLEventReader()
          获取此 StAXSource 使用的 XMLEventReader
 XMLStreamReader getXMLStreamReader()
          获取此 StAXSource 使用的 XMLStreamReader
 void setSystemId(String systemId)
          在 StAXSource 的上下文中,它不适合显示设置系统标识符。
 
从类 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 输入。

另请参见:
常量字段值
构造方法详细信息

StAXSource

public StAXSource(XMLEventReader xmlEventReader)
           throws XMLStreamException

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

XMLEventReader 必须为非 null 引用。

XMLEventReader 必须处于 XMLStreamConstants.START_DOCUMENTXMLStreamConstants.START_ELEMENT 状态。

参数:
xmlEventReader - 用于创建此 StAXSourceXMLEventReader
抛出:
XMLStreamException - 如果 xmlEventReader 访问抛出 Exception
IllegalArgumentException - 如果 xmlEventReader == null
IllegalStateException - 如果 xmlEventReader 不处于 XMLStreamConstants.START_DOCUMENTXMLStreamConstants.START_ELEMENT 状态。

StAXSource

public StAXSource(XMLStreamReader xmlStreamReader)

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

XMLStreamReader 必须为非 null 引用。

XMLStreamReader 必须处于 XMLStreamConstants.START_DOCUMENTXMLStreamConstants.START_ELEMENT 状态。

参数:
xmlStreamReader - 用于创建此 StAXSourceXMLStreamReader
抛出:
IllegalArgumentException - 如果 xmlStreamReader == null
IllegalStateException - 如果 xmlStreamReader 不处于 XMLStreamConstants.START_DOCUMENTXMLStreamConstants.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 的上下文中,它不适合显示设置系统标识符。用于构造此 StAXSourceXMLStreamReaderXMLEventReader 确定 XML 源的系统标识符。

此方法始终抛出 UnsupportedOperationException

指定者:
接口 Source 中的 setSystemId
参数:
systemId - 忽略。
抛出:
UnsupportedOperationException - 此方法始终抛出该异常。

getSystemId

public String getSystemId()

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

查询用于构造此 StAXSourceXMLStreamReaderXMLEventReader 以确定 XML 源的系统标识符。

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

指定者:
接口 Source 中的 getSystemId
返回:
StAXSource 使用的系统标识符。

JavaTM Platform
Standard Ed. 6

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

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