Java org.w3c.dom.ls 接口 LSOutput（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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