模块  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节“实体中的字符编码”),建议使用Internet Assigned Numbers Authority [ IANA-CHARSETS ]注册的字符编码(如charsets)使用他们的注册名称提到。
      • setEncoding

        void setEncoding​(String encoding)
        用于输出的字符编码。 编码必须是XML编码声明可接受的字符串([ XML 1.0 ]第4.3.3节“实体中的字符编码”),建议使用Internet Assigned Numbers Authority [ IANA-CHARSETS ]注册的字符编码(如charsets)使用他们的注册名称提到。