org.w3c.dom.ls

接口
异常
public interface DOMImplementationLS

DOMImplementationLS 包括创建 Load 和 Save 对象的工厂方法。

期望在 DOMImplementation 接口的实例上使用特定于绑定的 casting 方法获取 DOMImplementationLS 接口的实例,或者如果 Document 支持在 [DOM Level 3 Core] 中定义的功能 "Core" 版本 "3.0" ,通过分别使用带有参数值 "LS"(或 "LS-Async")和 "3.0"DOMImplementation.getFeature 方法来获取。

另请参见《Document Object Model (DOM) Level 3 Load and Save Specification》。


字段摘要
static short MODE_ASYNCHRONOUS
          创建一个异步 LSParser
static short MODE_SYNCHRONOUS
          创建一个同步 LSParser
 
方法摘要
 LSInput createLSInput()
          创建一个新的空输入源对象,其中,LSInput.characterStreamLSInput.byteStreamLSInput.stringData LSInput.systemIdLSInput.publicIdLSInput.baseURILSInput.encoding 为 null,LSInput.certifiedText 为 false。
 LSOutput createLSOutput()
          创建新的空输出目标对象,其中,LSOutput.characterStreamLSOutput.byteStreamLSOutput.systemIdLSOutput.encoding 为 null。
 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_SYNCHRONOUS,则所创建的 LSParser 将以同步模式操作,如果它是 MODE_ASYNCHRONOUS,则所创建的 LSParser 将以异步模式操作。
schemaType - 绝对 URI,表示在使用新创建的 LSParser 加载 Document 期间所使用的模式语言的类型。注意,不对绝对 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.characterStreamLSInput.byteStreamLSInput.stringData LSInput.systemIdLSInput.publicIdLSInput.baseURILSInput.encoding 为 null, LSInput.certifiedText 为 false。

返回:
新创建的输入对象。

createLSOutput

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

返回:
新创建的输出对象。