模块 java.xml
包 org.w3c.dom.ls

接口 LSOutput

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

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

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

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

LSSerializer 将使用 LSOutput 对象来确定将输出序列化到何处。 LSSerializer 将按以下顺序查看 LSOutput 中指定的不同输出，以了解要输出到哪个，将使用第一个非空且非空字符串的输出：

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

LSOutput 对象属于应用程序。 DOM 实现永远不会修改它们（尽管它可能会制作副本并在必要时修改副本）。

另见 文档对象模型 (DOM) 级别 3 加载和保存规范 。

自从：
1.5

  • 方法详情

    • 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 ] 注册的字符编码（作为字符集）应该是指使用他们的注册名称。