模块 java.xml

软件包 javax.xml.transform.sax

Class SAXSource

java.lang.Object

javax.xml.transform.sax.SAXSource

实现的所有接口

Source

public class SAXSourceextends Objectimplements Source

充当SAX风格源的持有者。

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

从以下版本开始：

1.4

字段汇总

字段

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

构造方法摘要

构造方法

构造器	描述
SAXSource()	零参数默认构造函数。
SAXSource(InputSource inputSource)	创建 SAXSource ，使用SAX InputSource 。
SAXSource(XMLReader reader, InputSource inputSource)	使用XMLReader和SAX InputSource创建SAXSource 。

方法摘要

变量和类型	方法	描述
InputSource	getInputSource()	获取要用于Source的SAX InputSource。
String	getSystemId()	获取将解析URI的基本ID（URI或系统ID）。
XMLReader	getXMLReader()	获取要用于Source的XMLReader。
boolean	isEmpty()	指示 SAXSource对象是否为空。
void	setInputSource(InputSource inputSource)	设置要用于源的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()

零参数默认构造函数。 如果此构造被使用，并且没有SAX源使用设置setInputSource(InputSource inputSource) ，那么Transformer将创建一个空的源代码InputSource使用new InputSource() 。

另请参见：

Transformer.transform(Source xmlSource, Result outputTarget)

SAXSource

public SAXSource(XMLReader reader,                 InputSource inputSource)

使用XMLReader和SAX InputSource创建SAXSource 。 Transformer或SAXTransformerFactory将自己设置为读者的ContentHandler ，然后将调用reader.parse（inputSource）。

参数

reader - 用于解析的XMLReader。

inputSource - SAX输入源引用，必须为非null且将传递给reader parse方法。

SAXSource

public SAXSource(InputSource inputSource)

创建SAXSource ，使用SAX InputSource 。 Transformer或SAXTransformerFactory创建一个阅读器（如果未使用setXMLReader），将其自身设置为阅读器的ContentHandler ，并调用reader.parse（inputSource）。

参数

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

方法详细信息

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)

设置要用于源的SAX InputSource。

参数

inputSource - 有效的InputSource引用。

getInputSource

public InputSource getInputSource()

获取要用于Source的SAX InputSource。

结果

有效的InputSource引用，或null。

setSystemId

public void setSystemId(String systemId)

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

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

Specified by:

setSystemId在界面 Source

参数

systemId - 系统标识符作为URI字符串。

getSystemId

public String getSystemId()

获取将解析URI的基本ID（URI或系统ID）。

Specified by:

getSystemId在界面 Source

结果

Source或 null基本URL。

sourceToInputSource

public static InputSource sourceToInputSource(Source source)

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

参数

source - 必须是非null源引用。

结果

InputSource，如果无法转换Source，则返回null。

isEmpty

public boolean isEmpty()

指示SAXSource对象是否为空。 Empty定义如下：

• 如果系统标识符和InputSource是null ;
• 如果系统标识符为null ，则InputSource为空。

Specified by:

isEmpty在界面 Source

结果

如果 SAXSource对象为空，则返回true，否则返回false