javax.xml.crypto.dom
類別 DOMCryptoContext

java.lang.Object
  javax.xml.crypto.dom.DOMCryptoContext

所有已實作的介面：

XMLCryptoContext

直接已知子類別：

DOMSignContext, DOMValidateContext

public class DOMCryptoContext
extends Object
implements XMLCryptoContext

此類別提供 XMLCryptoContext 介面特定於 DOM 的實作。它還包括特定於基於 DOM 的實作的其他方法，用於註冊和檢索包含型別 ID 的屬性的元素。

從以下版本開始：

1.6

建構子摘要

protected

DOMCryptoContext() 預設的建構子。

方法摘要

Object	get(Object key) 此實作使用內部 HashMap 獲取指定鍵所映射的物件。
String	getBaseURI() 返回基本 URI。
String	getDefaultNamespacePrefix() 返回預設名稱空間前綴。
Element	getElementById(String idValue) 返回具有指定 ID 屬性值的 Element。
KeySelector	getKeySelector() 返回用於尋找某個密鑰的密鑰選擇器。
String	getNamespacePrefix(String namespaceURI, String defaultPrefix) 此實作使用內部 HashMap 來獲取指定 URI 所映射的前綴。
Object	getProperty(String name) 此實作使用內部 HashMap 獲取指定名稱所映射的物件。
URIDereferencer	getURIDereferencer() 返回用來取消參考 URIReference 的 URIDereferencer。
Iterator	iterator() 返回可在此 DOMCryptoContext 的 Id/Element 映射集上進行迭代的只讀迭代器。
Object	put(Object key, Object value) 此實作使用內部 HashMap 將鍵映射到指定的物件。
String	putNamespacePrefix(String namespaceURI, String prefix) 此實作使用內部 HashMap 將 URI 映射到指定的前綴。
void	setBaseURI(String baseURI) 設置基本 URI。
void	setDefaultNamespacePrefix(String defaultPrefix) 設置預設的名稱空間前綴。
void	setIdAttributeNS(Element element, String namespaceURI, String localName) 將名稱空間 URI 和本地名稱指定的元素屬性註冊為型別 ID。
void	setKeySelector(KeySelector ks) 設置用於尋找某個密鑰的密鑰選擇器。
Object	setProperty(String name, Object value) 此實作使用內部 HashMap 將名稱映射到指定物件。
void	setURIDereferencer(URIDereferencer dereferencer) 設置用來取消參考 URIReference 的 URIDereferencer。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

DOMCryptoContext

protected DOMCryptoContext()

預設的建構子。（由子類別建構子調用）。

方法詳細資訊

getNamespacePrefix

public String getNamespacePrefix(String namespaceURI,
                                 String defaultPrefix)

此實作使用內部 HashMap 來獲取指定 URI 所映射的前綴。如果指定的 URI 映射到 null，則返回 defaultPrefix。

指定者：

介面 XMLCryptoContext 中的 getNamespacePrefix

參數：

namespaceURI - 名稱空間 URI

defaultPrefix - 在沒有將指定的名稱空間 URI 綁定到某一前綴的情況下將被返回的前綴。

返回：

與指定的名稱空間 URI 相關聯的前綴，如果沒有註冊 URI，則返回 defaultPrefix。如果已註冊名稱空間 URI，但沒有前綴，則返回一個空字元串 ("")。

拋出：

NullPointerException - 如果 namespaceURI 為 null

另請參見：

XMLCryptoContext.putNamespacePrefix(String, String)

putNamespacePrefix

public String putNamespacePrefix(String namespaceURI,
                                 String prefix)

此實作使用內部 HashMap 將 URI 映射到指定的前綴。

指定者：

介面 XMLCryptoContext 中的 putNamespacePrefix

參數：

namespaceURI - 名稱空間 URI

prefix - 名稱空間前綴（或者為 null，表示移除所有現有映射）。指定空字元串 ("") 則表示不將任何前綴綁定到名稱空間 URI。

返回：

與指定的名稱空間 URI 關聯以前使用的前綴，如果沒有任何前綴，則返回 null

拋出：

NullPointerException - 如果 namespaceURI 為 null

另請參見：

XMLCryptoContext.getNamespacePrefix(String, String)

getDefaultNamespacePrefix

public String getDefaultNamespacePrefix()

從介面 XMLCryptoContext 複製的描述

返回預設名稱空間前綴。預設的名稱空間前綴是用於所有名稱空間 URI 的前綴，該前綴未通過 putNamespacePrefix 方法顯式設置。

指定者：

介面 XMLCryptoContext 中的 getDefaultNamespacePrefix

返回：

預設的名稱空間前綴；如果未設置任何前綴，則返回 null。

另請參見：

XMLCryptoContext.setDefaultNamespacePrefix(String)

setDefaultNamespacePrefix

public void setDefaultNamespacePrefix(String defaultPrefix)

從介面 XMLCryptoContext 複製的描述

設置預設的名稱空間前綴。此方法可設置用於所有沒有通過 putNamespacePrefix 方法顯式設置的名稱空間 URI 的名稱空間前綴。

指定者：

介面 XMLCryptoContext 中的 setDefaultNamespacePrefix

參數：

defaultPrefix - 預設的名稱空間前綴；或者為 null，表示移除當前設置。指定空字元串 ("") 則表示不綁定任何前綴。

另請參見：

XMLCryptoContext.getDefaultNamespacePrefix()

getBaseURI

public String getBaseURI()

從介面 XMLCryptoContext 複製的描述

返回基本 URI。

指定者：

介面 XMLCryptoContext 中的 getBaseURI

返回：

基本 URI；如果未指定，則返回 null

另請參見：

XMLCryptoContext.setBaseURI(String)

setBaseURI

public void setBaseURI(String baseURI)

從介面 XMLCryptoContext 複製的描述

設置基本 URI。

指定者：

介面 XMLCryptoContext 中的 setBaseURI

參數：

baseURI - 基本 URI；或者為 null，表示移除當前值

拋出：

IllegalArgumentException - 如果 baseURI 與 RFC 2396 不相容

另請參見：

XMLCryptoContext.getBaseURI()

getURIDereferencer

public URIDereferencer getURIDereferencer()

從介面 XMLCryptoContext 複製的描述

返回用來取消參考 URIReference 的 URIDereferencer。

指定者：

介面 XMLCryptoContext 中的 getURIDereferencer

返回：

URIDereferencer；如果未指定，則返回 null

另請參見：

XMLCryptoContext.setURIDereferencer(URIDereferencer)

setURIDereferencer

public void setURIDereferencer(URIDereferencer dereferencer)

從介面 XMLCryptoContext 複製的描述

設置用來取消參考 URIReference 的 URIDereferencer。使用指定的 URIDereferencer 來代替某一實作的預設 URIDereferencer。

指定者：

介面 XMLCryptoContext 中的 setURIDereferencer

參數：

dereferencer - URIDereferencer；或者為 null，表示移除任何當前設置

另請參見：

XMLCryptoContext.getURIDereferencer()

getProperty

public Object getProperty(String name)

此實作使用內部 HashMap 獲取指定名稱所映射的物件。

指定者：

介面 XMLCryptoContext 中的 getProperty

參數：

name - 屬性名稱

返回：

指定的屬性的當前值；如果沒有這樣的值，則返回 null

拋出：

NullPointerException - 如果 name 為 null

另請參見：

XMLCryptoContext.setProperty(String, Object)

setProperty

public Object setProperty(String name,
                          Object value)

此實作使用內部 HashMap 將名稱映射到指定物件。

指定者：

介面 XMLCryptoContext 中的 setProperty

參數：

name - 屬性名稱

value - 要設置的屬性值

返回：

指定屬性的先前值；如果沒有這樣值，則返回 null

拋出：

NullPointerException - 如果 name 為 null

另請參見：

XMLCryptoContext.getProperty(String)

getKeySelector

public KeySelector getKeySelector()

從介面 XMLCryptoContext 複製的描述

返回用於尋找某個密鑰的密鑰選擇器。

指定者：

介面 XMLCryptoContext 中的 getKeySelector

返回：

密鑰選擇器；如果未指定，則返回 null

另請參見：

XMLCryptoContext.setKeySelector(KeySelector)

setKeySelector

public void setKeySelector(KeySelector ks)

從介面 XMLCryptoContext 複製的描述

設置用於尋找某個密鑰的密鑰選擇器。

指定者：

介面 XMLCryptoContext 中的 setKeySelector

參數：

ks - 密鑰選擇器；或者為 null，表示移除當前設置

另請參見：

XMLCryptoContext.getKeySelector()

getElementById

public Element getElementById(String idValue)

返回具有指定 ID 屬性值的 Element。

此實作使用內部 HashMap 獲取指定屬性值所映射的元素。

參數：

idValue - ID 值

返回：

具有指定 ID 屬性值的 Element；如果沒有，則返回 null。

拋出：

NullPointerException - 如果 idValue 為 null

另請參見：

setIdAttributeNS(org.w3c.dom.Element, java.lang.String, java.lang.String)

setIdAttributeNS

public void setIdAttributeNS(Element element,
                             String namespaceURI,
                             String localName)

將名稱空間 URI 和本地名稱指定的元素屬性註冊為型別 ID。該屬性必須有一個非空(null)值。

此實作使用內部 HashMap 將屬性值映射到指定元素。

參數：

element - 元素

namespaceURI - 屬性的名稱空間 URI（如果不適用，則指定 null）

localName - 屬性的本地名稱

拋出：

IllegalArgumentException - 如果 localName 不是指定元素的屬性，或者它不包含特定值

NullPointerException - 如果 element 或 localName 為 null

另請參見：

getElementById(java.lang.String)

iterator

public Iterator iterator()

返回可在此 DOMCryptoContext 的 Id/Element 映射集上進行迭代的只讀迭代器。試圖通過 Iterator.remove() 方法修改該映射集將導致拋出 UnsupportedOperationException。返回的映射沒有特定的順序。迭代的每個元素都被表示為一個 Map.Entry。如果在進行迭代期間修改了 DOMCryptoContext，則迭代的結果是不確定的。

返回：

可在映射集上進行迭代的只讀迭代器

get

public Object get(Object key)

此實作使用內部 HashMap 獲取指定鍵所映射的物件。

指定者：

介面 XMLCryptoContext 中的 get

參數：

key - 關聯值將被返回的鍵

返回：

此上下文將指定鍵映射到的值；如果沒有與該鍵有關的映射關係，則返回 null

另請參見：

XMLCryptoContext.put(Object, Object)

put

public Object put(Object key,
                  Object value)

此實作使用內部 HashMap 將鍵映射到指定的物件。

指定者：

介面 XMLCryptoContext 中的 put

參數：

key - 將與指定值關聯的鍵

value - 將與指定鍵關聯的值

返回：

與指定鍵關聯的以前的值；如果沒有與該鍵有關的映射關係，則返回 null

拋出：

IllegalArgumentException - 如果此鍵或值的某個方面阻止它存儲在此上下文中

另請參見：

XMLCryptoContext.get(Object)