Module  java.xml
软件包  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

    从以下版本开始:
    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 ]注册的字符编码(作为字符集)应为提到使用他们的注册名称。