Module java.xml
Package 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实现永远不会修改它们（尽管可能会复制并修改副本，如果必要）。

另请参阅文档对象模型（DOM）级别3加载和保存规范。

自：
1.5

  • Method Details

    • 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节“实体中的字符编码”），建议使用已在Internet分配号码管理局注册（作为字符集）的字符编码应使用其注册名称进行引用。

    • setEncoding

      void setEncoding(String encoding)
      用于输出的字符编码。编码必须是可接受的XML编码声明的字符串（[XML 1.0]第4.3.3节“实体中的字符编码”），建议使用已在Internet分配号码管理局注册（作为字符集）的字符编码应使用其注册名称进行引用。