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] 中注册的字符编码使用它们的注册名称来引用。