javax.xml.transform.stream
類別 StreamSource

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

所有已實作的介面：

Source

public class StreamSource
extends Object
implements Source

以 XML 標記串流的形式充當轉換 Source 的持有者。

註： 由於內部使用了 Reader 或 InputStream 實例的緣故，StreamSource 實例只能使用一次。

欄位摘要

static String

FEATURE 當將此值作為參數傳遞時，如果 TransformerFactory.getFeature(java.lang.String) 返回 true，則 Transformer 支持此型別的 Source。

建構子摘要

StreamSource()
零參數的預設建構子。

StreamSource(File f)
從 File 建構 StreamSource。

StreamSource(InputStream inputStream)
從位元組串流建構 StreamSource。

StreamSource(InputStream inputStream, String systemId)
從位元組串流建構 StreamSource。

StreamSource(Reader reader)
從字元 reader 建構 StreamSource。

StreamSource(Reader reader, String systemId)
從字元 reader 建構 StreamSource。

StreamSource(String systemId)
從 URL 建構 StreamSource。

方法摘要

InputStream	getInputStream() 獲取通過 setByteStream 設置的位元組串流。
String	getPublicId() 獲取通過 setPublicId 設置的公共標識符。
Reader	getReader() 獲取通過 setReader 設置的字元串流。
String	getSystemId() 獲取通過 setSystemId 設置的系統標識符。
void	setInputStream(InputStream inputStream) 設置要用作輸入的位元組串流。
void	setPublicId(String publicId) 設置此 Source 的公共標識符。
void	setReader(Reader reader) 調用要作為字元 reader 的輸入。
void	setSystemId(File f) 設置來自 File 參考的系統 ID。
void	setSystemId(String systemId) 設置此 Source 的系統標識符。

從類別 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。

另請參見：

常數欄位值

建構子詳細資訊

StreamSource

public StreamSource()

零參數的預設建構子。如果使用了此建構子，且未使用 setInputStream(java.io.InputStream inputStream) 或 setReader(java.io.Reader reader) 設置 Stream 源，則 Transformer 將使用 new InputStream() 創建空的源 InputStream。

另請參見：

Transformer.transform(Source xmlSource, Result outputTarget)

StreamSource

public StreamSource(InputStream inputStream)

從位元組串流建構 StreamSource。通常，應使用串流而不是 reader，以便 XML 解析器可以解析 XML 宣告所指定的字元編碼。

如果此建構子用於處理 stylesheet，通常還應調用 setSystemId，以便可以解析相對 URI 參考。

參數：

inputStream - 對 XML 串流的有效 InputStream 參考。

StreamSource

public StreamSource(InputStream inputStream,
                    String systemId)

從位元組串流建構 StreamSource。通常，應使用串流而不是 reader，以便 XML 解析器可以解析 XML 宣告所指定的字元編碼。

此建構子除允許設置輸入串流外，還允許設置 systemID，從而允許處理相對 URI。

參數：

inputStream - 對 XML 串流的有效 InputStream 參考。

systemId - 必須為遵守 URI 語法的 String。

StreamSource

public StreamSource(Reader reader)

從字元 reader 建構 StreamSource。通常，應使用串流而不是 reader，以便 XML 解析器可以解析 XML 宣告所指定的字元編碼。但是，許多情況下輸入串流編碼已得到解析，例如從 StringReader 讀取 XML 的情況。

參數：

reader - 對 XML 字元串流的有效 Reader 參考。

StreamSource

public StreamSource(Reader reader,
                    String systemId)

從字元 reader 建構 StreamSource。通常，應使用串流而不是 reader，以便 XML 解析器可以解析 XML 宣告所指定的字元編碼。但是，許多情況下輸入串流編碼已得到解析，例如從 StringReader 讀取 XML 的情況。

參數：

reader - 對 XML 字元串流的有效 Reader 參考。

systemId - 必須為遵守 URI 語法的 String。

StreamSource

public StreamSource(String systemId)

從 URL 建構 StreamSource。

參數：

systemId - 必須為遵守 URI 語法的 String。

StreamSource

public StreamSource(File f)

從 File 建構 StreamSource。

參數：

f - 必須為非 null File 參考。

方法詳細資訊

setInputStream

public void setInputStream(InputStream inputStream)

設置要用作輸入的位元組串流。通常，應使用串流而不是 reader，以便 XML 解析器可以解析 XML 宣告所指定的字元編碼。

如果此 Source 物件用於處理 stylesheet，通常還應調用 setSystemId，以便可以解析相對 URL 參考。

參數：

inputStream - 對 XML 串流的有效 InputStream 參考。

getInputStream

public InputStream getInputStream()

獲取通過 setByteStream 設置的位元組串流。

返回：

通過 setByteStream 設置的位元組串流，如果未調用 setByteStream 或 ByteStream 建構子，則返回 null。

setReader

public void setReader(Reader reader)

調用要作為字元 reader 的輸入。通常，應使用串流而不是 reader，以便 XML 解析器可以解析 XML 宣告所指定的字元編碼。但是，許多情況下輸入串流編碼已得到解析，例如從 StringReader 讀取 XML 的情況。

參數：

reader - 對 XML CharacterStream 的有效 Reader 參考。

getReader

public Reader getReader()

獲取通過 setReader 設置的字元串流。

返回：

通過 setReader 設置字元串流，如果未調用 setReader 或 Reader 建構子，則返回 null。

setPublicId

public void setPublicId(String publicId)

設置此 Source 的公共標識符。

公共標識符總是可選的：如果應用程序 writer 套件含一個公共標識符，則它將作為本地資訊的一部分來提供。

參數：

publicId - 字元串形式的公共標識符。

getPublicId

public String getPublicId()

獲取通過 setPublicId 設置的公共標識符。

返回：

通過 setPublicId 設置的公共標識符，如果未調用 setPublicId，則返回 null。

setSystemId

public void setSystemId(String systemId)

設置此 Source 的系統標識符。

如果有位元組串流或字元串流，則系統標識符是可選的，但提供系統標識符仍然很有用，因為應用程序可以用它來解析相對 URI，並可以將它包括在錯誤訊息和警告中（僅當未指定位元組串流或字元串流時，解析器才嘗試打開到 URI 的連接）。

指定者：

介面 Source 中的 setSystemId

參數：

systemId - URL 字元串形式的系統標識符。

getSystemId

public String getSystemId()

獲取通過 setSystemId 設置的系統標識符。

指定者：

介面 Source 中的 getSystemId

返回：

通過 setSystemId 設置的系統標識符，如果未調用 setSystemId，則返回 null。

setSystemId

public void setSystemId(File f)

設置來自 File 參考的系統 ID。

參數：

f - 必須為非 null File 參考。