站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

StAXSource (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助 
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 的形式（即 XMLStreamReader 或 XMLEventReader）充当 XML Source 的持有者。各种接受 Source 的情况下都可以使用 StAXSource，例如，将 Source 作为输入接受的 Transformer 和 Validator。

在处理期间使用 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_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 使用的系统标识符。
概述  软件包   类  使用  树  已过时  索引  帮助 
JavaTM Platform
Standard Ed. 6
 上一个类   下一个类 框架    无框架    
摘要： 嵌套 | 字段 | 构造方法 | 方法 详细信息： 字段 | 构造方法 | 方法
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

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