模块  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.characterStreamLSInput.byteStreamLSInput.stringData LSInput.systemIdLSInput.publicIdLSInput.baseURILSInput.encoding是空的, LSInput.certifiedText是假的。
      LSOutput createLSOutput()
      创建一个新的空输出目标对象,其中 LSOutput.characterStreamLSOutput.byteStreamLSOutput.systemIdLSOutput.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_SYNCHRONOUSMODE_ASYNCHRONOUS ,如果 modeMODE_SYNCHRONOUSLSParser所创建将在同步模式中操作,如果它是 MODE_ASYNCHRONOUSLSParser所创建将在异步模式下操作。
        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.characterStreamLSInput.byteStreamLSInput.stringData LSInput.systemIdLSInput.publicIdLSInput.baseURILSInput.encoding是空的, LSInput.certifiedText是假的。
        结果
        新创建的输入对象。
      • createLSOutput

        LSOutput createLSOutput()
        创建一个新的空输出目标对象,其中 LSOutput.characterStreamLSOutput.byteStreamLSOutput.systemIdLSOutput.encoding为空。
        结果
        新创建的输出对象。