compact2, compact3

org.w3c.dom.ls

Interface LSOutput

public interface LSOutput

该接口表示数据的输出目的地。

该接口允许应用程序将关于输出目的地的信息封装在单个对象中，该对象可以包括URI，字节流（可能具有指定的编码），基本URI和/或字符流。

字节流和字符流的确切定义是依赖于绑定的。

预计应用程序将提供在需要此类对象时实现此接口的对象。 应用程序可以提供实现此接口的自己的对象，也可以使用通用的工厂方法DOMImplementationLS.createLSOutput()来创建实现此接口的对象。

LSSerializer将使用LSOutput对象来确定将串行化输出的位置。 该LSSerializer将着眼于在指定的不同的输出LSOutput在下面以知道哪一个，以输出到，第一个是不为空，而不是一个空字符串将被使用：

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

LSOutput对象属于应用程序。 DOM实现永远不会修改它们（尽管如果需要，它可能会复制并修改副本）。

另见Document Object Model (DOM) Level 3 Load and Save Specification 。

方法摘要

Modifier and Type	Method and Description
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节“实体中的字符编码”），建议使用互联网号码分配机构注册的字符编码（作为字符集）[ IANA-CHARSETS ]应为提到使用他们的注册名称。

setEncoding

void setEncoding(String encoding)

用于输出的字符编码。 编码必须是XML编码声明可接受的字符串（[ XML 1.0 ]第4.3.3节“实体中的字符编码”），建议与互联网号码分配机构[ IANA-CHARSETS ]注册的字符编码（作为字符集）应为提到使用他们的注册名称。