模块  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）使用他们的注册名称提到。