Module java.xml

Interface Result

所有已知的实现类:
DOMResult, SAXResult, StAXResult, StreamResult

public interface Result

实现此接口的对象包含构建转换结果树所需的信息。

自从:
1.4
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    如果结果树禁用输出转义,则发送的处理指令的名称。
    static final String
    如果结果树在接收到 PI_DISABLE_OUTPUT_ESCAPING 处理指令后的某个时刻启用输出转义,则发送的处理指令的名称。
  • Method Summary

    Modifier and Type
    Method
    Description
    获取使用 setSystemId 设置的系统标识符。
    void
    setSystemId(String systemId)
    为此 Result 设置系统标识符。
  • Field Details

    • PI_DISABLE_OUTPUT_ESCAPING

      static final String PI_DISABLE_OUTPUT_ESCAPING
      如果结果树禁用输出转义,则发送的处理指令的名称。

      通常,结果树序列化在输出文本节点时会转义 & 和 <(可能还有其他字符)。这确保输出是格式良好的 XML。然而,有时候可以方便地生成几乎但不完全格式良好的 XML 输出;例如,输出可能包含将由后续非 XML 感知处理转换为格式良好的 XML 的非格式良好部分。如果发送带有此名称的处理指令,则序列化应该输出而不进行任何转义。

      结果 DOM 树也可能插入 PI_DISABLE_OUTPUT_ESCAPING 和 PI_ENABLE_OUTPUT_ESCAPING。

      参见:
    • PI_ENABLE_OUTPUT_ESCAPING

      static final String PI_ENABLE_OUTPUT_ESCAPING
      如果结果树在接收到 PI_DISABLE_OUTPUT_ESCAPING 处理指令后的某个时刻启用输出转义,则发送的处理指令的名称。
      参见:
  • Method Details

    • setSystemId

      void setSystemId(String systemId)
      为此 Result 设置系统标识符。

      如果不打算将 Result 写入文件,则系统标识符是可选的。但是,应用程序可能仍希望提供一个,以便在错误消息和警告中使用,或者解析相对输出标识符。

      参数:
      systemId - 作为 URI 字符串的系统标识符。
    • getSystemId

      String getSystemId()
      获取使用 setSystemId 设置的系统标识符。
      返回:
      使用 setSystemId 设置的系统标识符,如果未调用 setSystemId,则返回 null。