StreamSource (Java Platform SE 8 )

java.lang.Object
- javax.xml.transform.stream.StreamSource

All Implemented Interfaces:

Source
```
public class StreamSource
extends Object
implements Source
```
作为转换的持有人以XML标记流的形式来源。

注意：由于内部使用Reader或InputStream实例， StreamSource实例只能使用一次。

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`FEATURE` 如果 `TransformerFactory.getFeature(java.lang.String)`将该值作为参数传递时返回true，则Transformer支持此类型的Source输入。

构造方法摘要

构造方法
Constructor and Description
`StreamSource()` 零参数默认构造函数。
`StreamSource(File f)` 从文件构造一个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。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`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(File f)` 从文件引用设置系统ID。
`void`	`setSystemId(String systemId)` 设置此源的系统标识符。

Methods inherited from class 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输入。
    
    另请参见：
    
    Constant Field Values
- 构造方法详细信息
  - StreamSource
```
public StreamSource()
```
    零参数默认构造函数。如果此构造被使用，并且没有流源通过设置setInputStream(java.io.InputStream inputStream)或setReader(java.io.Reader reader) ，那么Transformer将创建一个空源InputStream使用new InputStream() 。
    
    另请参见：
    
    Transformer.transform(Source xmlSource, Result outputTarget)
  - StreamSource
```
public StreamSource(InputStream inputStream)
```
    从字节流构造一个StreamSource。通常，应该使用流而不是阅读器，因此XML解析器可以解析XML声明指定的字符编码。
    如果此构造函数用于处理样式表，则通常也应该调用setSystemId，以便可以解析相对URI引用。
    
    参数
    
    inputStream - 对XML流的有效InputStream引用。
  - StreamSource
```
public StreamSource(InputStream inputStream,
                    String systemId)
```
    从字节流构造一个StreamSource。通常，应该使用流而不是阅读器，以便XML解析器可以解析由XML声明指定的字符编码。
    该构造函数允许除了输入流之外还可以设置systemID，这允许处理相对URI。
    
    参数
    
    inputStream - 对XML流的有效InputStream引用。
    
    systemId - 必须是符合URI语法的字符串。
  - StreamSource
```
public StreamSource(Reader reader)
```
    从字符读取器构造一个StreamSource。通常，应该使用流而不是阅读器，以便XML解析器可以解析由XML声明指定的字符编码。然而，在许多情况下，输入流的编码已经解决了，就像从StringReader读取XML的情况一样。
    
    参数
    
    reader - 对XML字符流的有效读取器引用。
  - StreamSource
```
public StreamSource(Reader reader,
                    String systemId)
```
    从字符读取器构造一个StreamSource。通常，应该使用流而不是阅读器，以便XML解析器可以解析由XML声明指定的字符编码。然而，在许多情况下，输入流的编码已经解决了，就像从StringReader读取XML的情况一样。
    
    参数
    
    reader - 对XML字符流的有效阅读器引用。
    
    systemId - 必须是符合URI语法的字符串。
  - StreamSource
```
public StreamSource(String systemId)
```
    从URL构造一个StreamSource。
    
    参数
    
    systemId - 必须是符合URI语法的字符串。
  - StreamSource
```
public StreamSource(File f)
```
    从文件构造一个StreamSource。
    
    参数
    
    f - 必须是非空文件引用。
- 方法详细信息
  - setInputStream
```
public void setInputStream(InputStream inputStream)
```
    设置要用作输入的字节流。通常，应该使用流而不是阅读器，以便XML解析器可以解析由XML声明指定的字符编码。
    如果此Source对象用于处理样式表，则通常也应该调用setSystemId，以便可以解析相对URL引用。
    
    参数
    
    inputStream - 对XML流的有效InputStream引用。
  - getInputStream
```
public InputStream getInputStream()
```
    获取使用setByteStream设置的字节流。
    
    结果
    
    使用setByteStream设置的字节流，如果setByteStream或ByteStream构造函数未调用，则为null。
  - setReader
```
public void setReader(Reader reader)
```
    将输入设置为字符读取器。通常，应该使用流而不是阅读器，以便XML解析器可以解析由XML声明指定的字符编码。然而，在许多情况下，输入流的编码已经解决了，就像从StringReader读取XML的情况一样。
    
    参数
    
    reader - 对XML CharacterStream的有效读者引用。
  - getReader
```
public Reader getReader()
```
    获取用setReader设置的字符流。
    
    结果
    
    使用setReader设置的字符流，如果没有调用setReader或Reader构造函数，则为null。
  - setPublicId
```
public void setPublicId(String publicId)
```
    设置此源的公共标识符。
    公共标识符始终是可选的：如果应用程序写入程序包含一个，那么它将作为位置信息的一部分提供。
    
    参数
    
    publicId - 公共标识符作为字符串。
  - getPublicId
```
public String getPublicId()
```
    获取使用setPublicId设置的公共标识符。
    
    结果
    
    使用setPublicId设置的公共标识符，如果未调用setPublicId，则为null。
  - setSystemId
```
public void setSystemId(String systemId)
```
    设置此源的系统标识符。
    如果有字节流或字符流，则系统标识符是可选的，但是由于应用程序可以使用它来解析相对URI并且可以将其包含在错误消息和警告中（解析器将尝试仅当没有指定字节流或字符流时才打开与URI的连接）。
    
    Specified by:
    
    setSystemId在接口 Source
    
    参数
    
    systemId - 系统标识符作为URL字符串。
  - getSystemId
```
public String getSystemId()
```
    获取使用setSystemId设置的系统标识符。
    
    Specified by:
    
    getSystemId在界面 Source
    
    结果
    
    使用setSystemId设置的系统标识符，如果未调用setSystemId，则为null。
  - setSystemId
```
public void setSystemId(File f)
```
    从文件引用设置系统ID。
    
    参数
    
    f - 必须非空文件引用。

Class StreamSource

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

FEATURE

构造方法详细信息

StreamSource

StreamSource

StreamSource

StreamSource

StreamSource

StreamSource

StreamSource

方法详细信息

setInputStream

getInputStream

setReader

getReader

setPublicId

getPublicId

setSystemId

getSystemId

setSystemId