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