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。

返回：

新創建的輸出物件。