JavaTM 2 Platform
Standard Ed. 5.0

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


JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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