Module java.xml
Package org.w3c.dom.ls

Interface DOMImplementationLS

public interface DOMImplementationLS
DOMImplementationLS 包含用于创建加载和保存对象的工厂方法。

期望可以通过在 DOMImplementation 接口的实例上使用特定于绑定的转换方法来获取 DOMImplementationLS 接口的实例，或者如果 Document 支持 [DOM Level 3 Core] 中定义的特性 "Core" 版本 "3.0"，则可以通过使用参数值为 "LS"（或 "LS-Async"）和 "3.0" 的 DOMImplementation.getFeature 方法来获取。

另请参阅 文档对象模型（DOM）Level 3 加载和保存规范。

自版本:
1.5

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final short
    MODE_ASYNCHRONOUS
    创建一个异步 LSParser。
    static final short
    MODE_SYNCHRONOUS
    创建一个同步 LSParser。

  • Method Summary

    Modifier and Type
    Method
    Description
    LSInput
    createLSInput()
    创建一个新的空输入源对象，其中 LSInput.characterStream、LSInput.byteStream、LSInput.stringData、LSInput.systemId、LSInput.publicId、LSInput.baseURI 和 LSInput.encoding 都为 null，LSInput.certifiedText 为 false。
    LSOutput
    createLSOutput()
    创建一个新的空输出目标对象，其中 LSOutput.characterStream、LSOutput.byteStream、LSOutput.systemId、LSOutput.encoding 都为 null。
    LSParser
    createLSParser(short mode, String schemaType)
    创建一个新的 LSParser。
    LSSerializer
    createLSSerializer()
    创建一个新的 LSSerializer 对象。

  • Field Details

    • MODE_SYNCHRONOUS

      static final short MODE_SYNCHRONOUS
      创建一个同步 LSParser。
      另请参阅:

    • MODE_ASYNCHRONOUS

      static final short MODE_ASYNCHRONOUS
      创建一个异步 LSParser。
      另请参阅:

  • Method Details

    • createLSParser

      LSParser createLSParser(short mode, String schemaType) throws DOMException
      创建一个新的 LSParser。然后可以通过其 DOMConfiguration 对象配置新构建的解析器，并通过其 parse 方法解析文档。
      参数:
      mode - mode 参数为 MODE_SYNCHRONOUS 或 MODE_ASYNCHRONOUS，如果 mode 为 MODE_SYNCHRONOUS，则创建的 LSParser 将以同步模式运行，如果为 MODE_ASYNCHRONOUS，则创建的 LSParser 将以异步模式运行。
      schemaType - 表示在使用新创建的 LSParser 加载 Document 时所使用的模式语言类型的绝对 URI。请注意，绝对 URI 上不进行词法检查。为了为任何类型的模式创建 LSParser（即 LSParser 将自由使用找到的任何模式），请使用值 null。

      注意: 对于 W3C XML Schema [XML Schema Part 1]，应用程序必须使用值 "http://www.w3.org/2001/XMLSchema"。对于 XML DTD [XML 1.0]，应用程序必须使用值 "http://www.w3.org/TR/REC-xml"。其他模式语言超出了 W3C 的范围，因此应推荐一个绝对 URI 以便使用此方法。

      返回:
      新创建的 LSParser 对象。该 LSParser 可以是同步或异步的，具体取决于 mode 参数的值。

      注意: 默认情况下，新创建的 LSParser 不包含 DOMErrorHandler，即 "error-handler" 配置参数的值为 null。但是，实现可能在创建时提供默认错误处理程序。在这种情况下，新 LSParser 对象的 "error-handler" 配置参数的初始值包含对默认错误处理程序的引用。

      抛出:
      DOMException - NOT_SUPPORTED_ERR: 如果请求的模式或模式类型不受支持。

    • createLSSerializer

      LSSerializer createLSSerializer()
      创建一个新的 LSSerializer 对象。
      返回:
      新创建的 LSSerializer 对象。

      注意: 默认情况下，新创建的 LSSerializer 没有 DOMErrorHandler，即 "error-handler" 配置参数的值为 null。但是，实现可能在创建时提供默认错误处理程序。在这种情况下，新 LSSerializer 对象的 "error-handler" 配置参数的初始值包含对默认错误处理程序的引用。

    • createLSInput

      LSInput createLSInput()
      创建一个新的空输入源对象，其中 LSInput.characterStream、LSInput.byteStream、LSInput.stringData、LSInput.systemId、LSInput.publicId、LSInput.baseURI 和 LSInput.encoding 都为 null，LSInput.certifiedText 为 false。
      返回:
      新创建的输入对象。

    • createLSOutput

      LSOutput createLSOutput()
      创建一个新的空输出目标对象，其中 LSOutput.characterStream、LSOutput.byteStream、LSOutput.systemId、LSOutput.encoding 都为 null。
      返回:
      新创建的输出对象。