org.w3c.dom.ls
介面 LSOutput

public interface LSOutput

此介面表示資料的輸出目標。

此介面允許應用程序封裝有關單個物件中的輸出目標的資訊，它可包括 URI、位元組串流（可能帶有指定的編碼）、基 URI 和/或字元串流。

對位元組串流和字元串流的精確定義具有綁定依賴性。

當需要這種物件時，期望應用程序提供實作此介面的物件。應用程序既可以提供自己的實作此介面的物件，也可以使用一般的處理器方法 DOMImplementationLS.createLSOutput() 來創建實作此介面的物件。

LSSerializer 將使用 LSOutput 物件來確定將輸出序列化到何處。LSSerializer 將按照下面的順序查看在 LSOutput 中指定的不同輸出，以瞭解輸出到哪個當中，將使用不為 null 並且不是空字元串的第一個輸出：

1. LSOutput.characterStream
2. LSOutput.byteStream
3. LSOutput.systemId

LSOutput 物件屬於該應用程序。DOM 實作永遠不會修改這些物件（儘管可在必要時制做副本和修改副本）。

另請參見《Document Object Model (DOM) Level 3 Load and Save Specification》。

方法摘要

OutputStream	getByteStream() 具有語言和綁定依賴性型別的屬性，表示位元組的可寫串流。
Writer	getCharacterStream() 具有語言和綁定依賴性型別的屬性，它表示可向其輸出 16 位單元的可寫串流。
String	getEncoding() 用於輸出的字元編碼。
String	getSystemId() 系統標識符，它是此輸出目標的 URI 參考 [IETF RFC 2396]。
void	setByteStream(OutputStream byteStream) 具有語言和綁定依賴性型別的屬性，表示位元組的可寫串流。
void	setCharacterStream(Writer characterStream) 具有語言和綁定依賴性型別的屬性，它表示可向其輸出 16 位單元的可寫串流。
void	setEncoding(String encoding) 用於輸出的字元編碼。
void	setSystemId(String systemId) 系統標識符，它是此輸出目標的 URI 參考 [IETF RFC 2396]。

方法詳細資訊

getCharacterStream

Writer getCharacterStream()

具有語言和綁定依賴性型別的屬性，它表示可向其輸出 16 位單元的可寫串流。

setCharacterStream

void setCharacterStream(Writer characterStream)

具有語言和綁定依賴性型別的屬性，它表示可向其輸出 16 位單元的可寫串流。

getByteStream

OutputStream getByteStream()

具有語言和綁定依賴性型別的屬性，表示位元組的可寫串流。

setByteStream

void setByteStream(OutputStream byteStream)

具有語言和綁定依賴性型別的屬性，表示位元組的可寫串流。

getSystemId

String getSystemId()

系統標識符，它是此輸出目標的 URI 參考 [IETF RFC 2396]。
如果系統 ID 是相對 URI 參考（參見 [IETF RFC 2396] 中的 5 節），則該行為具有實作依賴性。

setSystemId

void setSystemId(String systemId)

系統標識符，它是此輸出目標的 URI 參考 [IETF RFC 2396]。
如果系統 ID 是相對 URI 參考（參見 [IETF RFC 2396] 中的 5 節），則該行為具有實作依賴性。

getEncoding

String getEncoding()

用於輸出的字元編碼。編碼必須是 XML 編碼宣告（[XML 1.0] 的 4.3.3 節 "Character Encoding in Entities"）可接受的字元串，建議在“國際因特網位址分派委員會”[IANA-CHARSETS] 註冊的字元編碼應該使用它們的註冊名稱來參考。

setEncoding

void setEncoding(String encoding)

用於輸出的字元編碼。編碼必須是 XML 編碼宣告（[XML 1.0] 的 4.3.3 節 "Character Encoding in Entities"）可接受的字元串，建議在“國際因特網位址分派委員會”[IANA-CHARSETS] 中註冊的字元編碼使用它們的註冊名稱來參考。