javax.xml.transform.sax
类 SAXSource

java.lang.Object
  javax.xml.transform.sax.SAXSource

所有已实现的接口：

Source

public class SAXSource
extends Object
implements Source

充当 SAX 样式 Source 的持有者。

注意，XSLT 要求名称空间支持。尝试转换不是通过名称空间感知的解析器生成的输入源可能导致错误。通过调用 SAXParserFactory.setNamespaceAware(boolean awareness) 方法可以使解析器具有名称空间感知的功能。

字段摘要

static String

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

构造方法摘要

SAXSource()
零参数的默认构造方法。

SAXSource(InputSource inputSource)
使用 SAX InputSource，创建 SAXSource。

SAXSource(XMLReader reader, InputSource inputSource)
使用 XMLReader 和 SAX InputSource 创建 SAXSource。

方法摘要

InputSource	getInputSource() 获取要用于 Source 的 SAX InputSource。
String	getSystemId() 获取要从其解析 URI 的基本 ID（URI 或系统 ID）。
XMLReader	getXMLReader() 获取要用于 Source 的 XMLReader。
void	setInputSource(InputSource inputSource) 设置要用于 Source 的 SAX InputSource。
void	setSystemId(String systemId) 设置此 Source 的系统标识符。
void	setXMLReader(XMLReader reader) 设置要用于 Source 的 XMLReader。
static InputSource	sourceToInputSource(Source source) 尝试从 Source 对象获取 SAX InputSource 对象。

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

FEATURE

public static final String FEATURE

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

另请参见：

常量字段值

构造方法详细信息

SAXSource

public SAXSource()

零参数的默认构造方法。如果使用了此构造方法，且未使用 setInputSource(InputSource inputSource) 设置 SAX 源，则 Transformer 将使用 new InputSource() 创建空的源 InputSource。

另请参见：

Transformer.transform(Source xmlSource, Result outputTarget)

SAXSource

public SAXSource(XMLReader reader,
                 InputSource inputSource)

使用 XMLReader 和 SAX InputSource 创建 SAXSource。Transformer 或 SAXTransformerFactory 将其本身设置为 reader 的 ContentHandler，然后将调用 reader.parse(inputSource)。

参数：

reader - 要用于解析的 XMLReader。

inputSource - 必须为非 null 且将被传递给 reader 解析方法的 SAX 输入源引用。

SAXSource

public SAXSource(InputSource inputSource)

使用 SAX InputSource，创建 SAXSource。Transformer 或 SAXTransformerFactory 通过 XMLReaderFactory（如果未使用 setXMLReader）创建 reader，将其本身设置为该 reader 的 ContentHandler，并调用 reader.parse(inputSource)。

参数：

inputSource - 必须为非 null 且将传递给 reader 的解析方法的输入源引用。

方法详细信息

setXMLReader

public void setXMLReader(XMLReader reader)

设置要用于 Source 的 XMLReader。

参数：

reader - 有效的 XMLReader 或 XMLFilter 引用。

getXMLReader

public XMLReader getXMLReader()

获取要用于 Source 的 XMLReader。

返回：

有效的 XMLReader 或 XMLFilter 引用，或者返回 null。

setInputSource

public void setInputSource(InputSource inputSource)

设置要用于 Source 的 SAX InputSource。

参数：

inputSource - 有效的 InputSource 引用。

getInputSource

public InputSource getInputSource()

获取要用于 Source 的 SAX InputSource。

返回：

有效的 InputSource 引用，或 null。

setSystemId

public void setSystemId(String systemId)

设置此 Source 的系统标识符。如果已设置输入源，则它将设置系统 ID 或该输入源，否则它将创建新输入源。

如果有字节流或字符流，则系统标识符是可选的，但提供系统标识符仍然很有用，因为应用程序可以用它来解析相对 URI，并可以将它包括在错误消息和警告中（仅当未指定字节流或字符流时，解析器才尝试打开到 URI 的连接）。

指定者：

接口 Source 中的 setSystemId

参数：

systemId - URI 字符串形式的系统标识符。

getSystemId

public String getSystemId()

获取要从其解析 URI 的基本 ID（URI 或系统 ID）。

指定者：

接口 Source 中的 getSystemId

返回：

Source 的基本 URL，或 null。

sourceToInputSource

public static InputSource sourceToInputSource(Source source)

尝试从 Source 对象获取 SAX InputSource 对象。

参数：

source - 必须为非 null Source 引用。

返回：

InputSource，如果不能转换 Source，则返回 null。