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) |
|
|---|---|
java.lang.Object
|
|
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. |