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. |