- java.lang.Object
-
- javax.xml.transform.stax.StAXSource
-
- 实现的所有接口
-
Source
public class StAXSource extends Object implements Source
作为StAX读取器形式的XML
Source
的持有者,即XMLStreamReader
或XMLEventReader
。StAXSource
可以在接受所有情况下使用Source
,例如Transformer
,Validator
其接受Source
作为输入。StAXSource
s在处理期间消耗,不可重复使用。- 从以下版本开始:
- 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()
获取此XMLEventReader
使用的StAXSource
。XMLStreamReader
getXMLStreamReader()
获取此XMLStreamReader
使用的StAXSource
。boolean
isEmpty()
指示StAXSource
对象是否为空。void
setSystemId(String systemId)
在StAXSource
的上下文中,不明确设置系统标识符。
-
-
-
字段详细信息
-
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
-XMLEventReader
用于创建此StAXSource
。 - 异常
-
XMLStreamException
- 如果xmlEventReader
访问投掷异常
。 -
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
-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
的XMLStreamReader
或XMLEventReader
以确定XML源的系统标识符。系统标识符可以是
null
或空""
String
。- Specified by:
-
getSystemId
in interfaceSource
- 结果
-
StAXSource
使用的系统标识符。
-
-