public class StreamSource
extends Object
implements Source
java.lang.Object | |
↳ | javax.xml.transform.stream.StreamSource |
充当XML标记流形式的转换源的持有者。
注意:由于内部使用 Reader
或 InputStream
实例,因此 StreamSource
实例只能使用一次。
Constants |
|
---|---|
String |
FEATURE 如果 |
Public constructors |
|
---|---|
StreamSource() 零参数默认构造函数。 |
|
StreamSource(InputStream inputStream) 从字节流构造一个StreamSource。 |
|
StreamSource(InputStream inputStream, String systemId) 从字节流构造一个StreamSource。 |
|
StreamSource(Reader reader) 从角色阅读器构造StreamSource。 |
|
StreamSource(Reader reader, String systemId) 从角色阅读器构造StreamSource。 |
|
StreamSource(String systemId) 从URL构建StreamSource。 |
|
StreamSource(File f) 从文件构建StreamSource。 |
Public methods |
|
---|---|
InputStream |
getInputStream() 获取使用setByteStream设置的字节流。 |
String |
getPublicId() 获取setPublicId设置的公共标识符。 |
Reader |
getReader() 获取使用setReader设置的字符流。 |
String |
getSystemId() 获取使用setSystemId设置的系统标识符。 |
void |
setInputStream(InputStream inputStream) 设置要用作输入的字节流。 |
void |
setPublicId(String publicId) 设置此源的公共标识符。 |
void |
setReader(Reader reader) 将输入设置为字符阅读器。 |
void |
setSystemId(String systemId) 设置此源的系统标识符。 |
void |
setSystemId(File f) 从文件引用中设置系统ID。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface javax.xml.transform.Source
|
String FEATURE
如果 getFeature(String)
在将此值作为参数传递时返回true,则Transformer支持此类型的源输入。
常量值:“http://javax.xml.transform.stream.StreamSource/feature”
StreamSource ()
零参数默认构造函数。 如果此构造被使用,并且没有流源通过设置setInputStream(java.io.InputStream)
或者setReader(java.io.Reader)
,那么Transformer
将创建一个空源InputStream
使用new InputStream()
。
也可以看看:
StreamSource (InputStream inputStream)
从字节流构造一个StreamSource。 通常,应该使用流而不是读取器,因此XML解析器可以解析由XML声明指定的字符编码。
如果此构造函数用于处理样式表,则通常也应调用setSystemId,以便可以解析相对URI引用。
Parameters | |
---|---|
inputStream |
InputStream : A valid InputStream reference to an XML stream. |
StreamSource (InputStream inputStream, String systemId)
从字节流构造一个StreamSource。 通常,应该使用流而不是读取器,以便XML解析器可以解析由XML声明指定的字符编码。
此构造函数允许除输入流之外还设置systemID,这允许处理相对URI。
Parameters | |
---|---|
inputStream |
InputStream : A valid InputStream reference to an XML stream. |
systemId |
String : Must be a String that conforms to the URI syntax. |
StreamSource (Reader reader)
从角色阅读器构造StreamSource。 通常,应该使用流而不是读取器,以便XML解析器可以解析由XML声明指定的字符编码。 但是,在许多情况下,输入流的编码已经解决,就像从StringReader读取XML一样。
Parameters | |
---|---|
reader |
Reader : A valid Reader reference to an XML character stream. |
StreamSource (Reader reader, String systemId)
从角色阅读器构造StreamSource。 通常,应该使用流而不是读取器,以便XML解析器可以解析由XML声明指定的字符编码。 但是,在许多情况下,输入流的编码已经解决,就像从StringReader读取XML一样。
Parameters | |
---|---|
reader |
Reader : A valid Reader reference to an XML character stream. |
systemId |
String : Must be a String that conforms to the URI syntax. |
StreamSource (String systemId)
从URL构建StreamSource。
Parameters | |
---|---|
systemId |
String : Must be a String that conforms to the URI syntax. |
StreamSource (File f)
从文件构建StreamSource。
Parameters | |
---|---|
f |
File : Must a non-null File reference. |
InputStream getInputStream ()
获取使用setByteStream设置的字节流。
Returns | |
---|---|
InputStream |
The byte stream that was set with setByteStream, or null if setByteStream or the ByteStream constructor was not called. |
String getPublicId ()
获取setPublicId设置的公共标识符。
Returns | |
---|---|
String |
The public identifier that was set with setPublicId, or null if setPublicId was not called. |
Reader getReader ()
获取使用setReader设置的字符流。
Returns | |
---|---|
Reader |
The character stream that was set with setReader, or null if setReader or the Reader constructor was not called. |
String getSystemId ()
获取使用setSystemId设置的系统标识符。
Returns | |
---|---|
String |
The system identifier that was set with setSystemId, or null if setSystemId was not called. |
void setInputStream (InputStream inputStream)
设置要用作输入的字节流。 通常,应该使用流而不是读取器,以便XML解析器可以解析由XML声明指定的字符编码。
如果此Source对象用于处理样式表,则通常也应调用setSystemId,以便可以解析相对URL引用。
Parameters | |
---|---|
inputStream |
InputStream : A valid InputStream reference to an XML stream. |
void setPublicId (String publicId)
设置此源的公共标识符。
公共标识符始终是可选的:如果应用程序编写器包含一个,它将作为位置信息的一部分提供。
Parameters | |
---|---|
publicId |
String : The public identifier as a string. |
void setReader (Reader reader)
将输入设置为字符阅读器。 通常,应该使用流而不是读取器,以便XML解析器可以解析由XML声明指定的字符编码。 但是,在许多情况下,输入流的编码已经解决,就像从StringReader读取XML一样。
Parameters | |
---|---|
reader |
Reader : A valid Reader reference to an XML CharacterStream. |
void setSystemId (String systemId)
设置此源的系统标识符。
如果有字节流或字符流,则系统标识符是可选的,但提供一个字符流仍然有用,因为应用程序可以使用它来解析相对URI并将其包含在错误消息和警告中(解析器将尝试只有在没有指定字节流或字符流的情况下才打开与URI的连接)。
Parameters | |
---|---|
systemId |
String : The system identifier as a URL string. |
void setSystemId (File f)
从文件引用中设置系统ID。
Parameters | |
---|---|
f |
File : Must a non-null File reference. |