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 。

Class StAXSource

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

FEATURE

构造方法详细信息

StAXSource

StAXSource

方法详细信息

getXMLEventReader

getXMLStreamReader

setSystemId

getSystemId