JavaTM 2 Platform
Standard Ed. 5.0

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 创建 SAXSourceTransformerSAXTransformerFactory 将其本身设置为 reader 的 ContentHandler,然后将调用 reader.parse(inputSource)。

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

SAXSource

public SAXSource(InputSource inputSource)
使用 SAX InputSource,创建 SAXSourceTransformerSAXTransformerFactory 通过 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。

JavaTM 2 Platform
Standard Ed. 5.0

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

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