模块  java.xml
软件包  org.w3c.dom.ls

Interface DOMImplementationLS

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

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

    另见Document Object Model (DOM) Level 3 Load and Save Specification 。

    从以下版本开始：
    1.5

    • 方法摘要

      所有方法  实例方法 抽象方法 
      变量和类型 方法 描述
      LSInput createLSInput()
      创建一个新的空输入源对象，其中 LSInput.characterStream ， LSInput.byteStream ， LSInput.stringData LSInput.systemId ， LSInput.publicId ， LSInput.baseURI和 LSInput.encoding是空的， LSInput.certifiedText是假的。
      LSOutput createLSOutput()
      创建一个新的空输出目标对象，其中 LSOutput.characterStream ， LSOutput.byteStream ， LSOutput.systemId ， LSOutput.encoding为空。
      LSParser createLSParser​(short mode, String schemaType)
      创建一个新的 LSParser 。
      LSSerializer createLSSerializer()
      创建一个新的 LSSerializer对象。

    • 字段详细信息

      • MODE_SYNCHRONOUS

        static final short MODE_SYNCHRONOUS
        创建同步 LSParser 。
        另请参见：
        常数字段值

      • MODE_ASYNCHRONOUS

        static final short MODE_ASYNCHRONOUS
        创建异步 LSParser 。
        另请参见：
        常数字段值

    • 方法详细信息

      • 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" 。 其他Schema语言不在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是空的， LSInput.certifiedText是假的。
        结果
        新创建的输入对象。

      • createLSOutput

        LSOutput createLSOutput()
        创建一个新的空输出目标对象，其中 LSOutput.characterStream ， LSOutput.byteStream ， LSOutput.systemId ， LSOutput.encoding为空。
        结果
        新创建的输出对象。