org.w3c.dom.ls

接口
异常

org.w3c.dom.ls
接口 DOMImplementationLS

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.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 对象。
 

字段详细信息

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 - 绝对 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.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。

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