org.w3c.dom.ls
介面 LSResourceResolver

public interface LSResourceResolver

LSResourceResolver 為應用程序提供了將參考重定向到外部資源的方法。

需要對外部資源實作自定義處理的應用程序可以實作此介面並通過設置連接到 LSParser 和 LSSerializer 的 DOMConfiguration 物件的 "resource-resolver" 參數註冊其實作。如果受 "LS" 功能受，該應用程序還可以在連接到 Document 的 DOMConfiguration 物件上註冊。

然後 LSParser 將允許應用程序在包含它們以前截取任何外部實體，其中包括外部 DTD 子集和外部參數實體。從不會將頂級文檔實體傳輸給 resolveResource 方法。

許多 DOM 應用程序將不需要實作此介面，但對於從資料庫或其他特定的輸入源中建構 XML 文檔的應用程序，或者使用 URN 的應用程序來說，這特別有用。

註：LSResourceResolver 基於 SAX2 [SAX] EntityResolver 介面。

另請參見《Document Object Model (DOM) Level 3 Load and Save Specification》。

方法摘要

LSInput

resolveResource(String type, String namespaceURI, String publicId, String systemId, String baseURI) 允許應用程序解析外部資源。

方法詳細資訊

resolveResource

LSInput resolveResource(String type,
                        String namespaceURI,
                        String publicId,
                        String systemId,
                        String baseURI)

允許應用程序解析外部資源。
LSParser 將在打開任何外部資源前調用此方法，外部資源包括外部 DTD 子集、在 DTD 中參考的外部實體、在文檔元素中參考的外部實體（但是不將頂級文檔實體傳遞給此方法）。應用程序然後可以請求 LSParser 解析使用替換的 URI或者使用完全不同的輸入源的外部資源本身。
應用程序編寫者可以使用此方法將外部系統標識符重定向到安全和/或本地 URI，在目錄中尋找公共標識符，或從資料庫或其他輸入源（例如包括對話框）中讀取實體。

參數：

type - 被解析的資源的型別。對於 XML [XML 1.0] 資源（即實體），應用程序必須使用值 "http://www.w3.org/TR/REC-xml"。對於 XML 網要 [XML Schema Part 1]，應用程序必須使用值 "http://www.w3.org/2001/XMLSchema"。其他型別的資源在此規範的範圍之外，因此為了使用此方法應當推薦絕對 URI。

namespaceURI - 被解析資源的名稱空間，例如，解析 XML Schema 資源時 XML Schema [XML Schema Part 1] 的目標名稱空間。

publicId - 被參考的外部實體的公共標識符，如果沒有提供公共標識符或者資源不是實體，則為 null。

systemId - 公共標識符，它是被參考的外部資源的 URI 參考 [IETF RFC 2396]，如果沒有提供系統標識符，則為 null。

baseURI - 被解析資源的絕對基 URI，如果沒有基 URI，則為 null。

返回：

一個描述新的輸入源的 LSInput 物件，或者返回 null 以請求解析器打開到該資源的規則 URI 連接。