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》。

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

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。