javax.xml.crypto
インタフェース XMLCryptoContext

既知のサブインタフェースの一覧:

XMLSignContext, XMLValidateContext

既知の実装クラスの一覧:

DOMCryptoContext, DOMSignContext, DOMValidateContext

public interface XMLCryptoContext

XML 暗号化処理についての共通コンテキスト情報を格納します。 　

このインタフェースには、XML 署名または XML 暗号化された構造の処理に影響するプロパティーを、設定または取得するためのメソッドが格納されます。 　

XMLCryptoContext インスタンスには、ともに使用される XML 暗号化構造に固有の情報および状態を格納できます。XMLCryptoContext が複数の構造とともに使用された場合、予想外の結果となります。たとえば、同じ XMLValidateContext インスタンスを使用して 2 つの異なる XMLSignature オブジェクトを検証すべきではありません。

導入されたバージョン:

1.6

メソッドの概要

Object	get(Object key) このコンテキストが指定されたキーにマップされる値を返します。
String	getBaseURI() ベース URI を返します。
String	getDefaultNamespacePrefix() デフォルトの名前空間接頭辞を返します。
KeySelector	getKeySelector() キーの検索用のキーセレクタを返します。
String	getNamespacePrefix(String namespaceURI, String defaultPrefix) 指定した名前空間 URI が関連付けられる名前空間接頭辞を返します。
Object	getProperty(String name) 指定されたプロパティーの値を返します。
URIDereferencer	getURIDereferencer() URIReference の間接参照に使用される URIDereferencer を返します。
Object	put(Object key, Object value) このコンテキストで、指定された値を指定されたキーに関連付けます。
String	putNamespacePrefix(String namespaceURI, String prefix) 指定した名前空間 URI を指定した接頭辞にマッピングします。
void	setBaseURI(String baseURI) ベース URI を設定します。
void	setDefaultNamespacePrefix(String defaultPrefix) デフォルトの名前空間接頭辞を設定します。
void	setKeySelector(KeySelector ks) キーの検索用のキーセレクタを設定します。
Object	setProperty(String name, Object value) 指定したプロパティーを設定します。
void	setURIDereferencer(URIDereferencer dereferencer) URIReference の間接参照に使用される URIDereferencer を設定します。

メソッドの詳細

getBaseURI

String getBaseURI()

ベース URI を返します。

戻り値:

ベース URI。または指定されない場合は null

関連項目:

setBaseURI(String)

setBaseURI

void setBaseURI(String baseURI)

ベース URI を設定します。

パラメータ:

baseURI - ベース URI。または現在の値を削除する場合は null

例外:

IllegalArgumentException - baseURI が RFC 2396 準拠でない場合

関連項目:

getBaseURI()

getKeySelector

KeySelector getKeySelector()

キーの検索用のキーセレクタを返します。

戻り値:

キーセレクタ。または指定されない場合は null

関連項目:

setKeySelector(KeySelector)

setKeySelector

void setKeySelector(KeySelector ks)

キーの検索用のキーセレクタを設定します。

パラメータ:

ks - キーセレクタ。または現在の設定を削除する場合は null

関連項目:

getKeySelector()

getURIDereferencer

URIDereferencer getURIDereferencer()

URIReference の間接参照に使用される URIDereferencer を返します。

戻り値:

URIDereferencer。指定されていない場合は null

関連項目:

setURIDereferencer(URIDereferencer)

setURIDereferencer

void setURIDereferencer(URIDereferencer dereferencer)

URIReference の間接参照に使用される URIDereferencer を設定します。 指定した URIDereferencer は、実装のデフォルト URIDereferencer の代わりに使用されます。

パラメータ:

dereferencer - URIDereferencer、または 現在の設定を削除する場合は null

関連項目:

getURIDereferencer()

getNamespacePrefix

String getNamespacePrefix(String namespaceURI,
                          String defaultPrefix)

指定した名前空間 URI が関連付けられる名前空間接頭辞を返します。指定した名前空間 URI が接頭辞にバインドされていない場合、指定したデフォルトの接頭辞を返します。名前空間 URI を接頭辞にバインドするには、putNamespacePrefix メソッドを呼び出します。

パラメータ:

namespaceURI - 名前空間 URI

defaultPrefix - 指定した名前空間 URI が接頭辞にバインドされていない場合に 返される接頭辞

戻り値:

指定した名前空間 URI と関連付けられた接頭辞、 または URI が登録されていない場合は defaultPrefix。 名前空間 URI が登録されていて接頭辞がない場合、空の文字列 ("") が返されます。

例外:

NullPointerException - namespaceURI が null の場合

関連項目:

putNamespacePrefix(String, String)

putNamespacePrefix

String putNamespacePrefix(String namespaceURI,
                          String prefix)

指定した名前空間 URI を指定した接頭辞にマッピングします。指定した名前空間 URI と関連付けられた接頭辞がすでに存在する場合、古い接頭辞は指定された接頭辞に置き換えられます。

パラメータ:

namespaceURI - 名前空間 URI

prefix - 名前空間接頭辞 (既存のマッピングをすべて削除する場合は null。 空の文字列 ("") を指定すると、接頭辞は 名前空間 URI にバインドされません。

戻り値:

指定した名前空間 URI と関連付けられた以前の接頭辞、 または 1 つもない場合は null

例外:

NullPointerException - namespaceURI が null の場合

関連項目:

getNamespacePrefix(String, String)

getDefaultNamespacePrefix

String getDefaultNamespacePrefix()

デフォルトの名前空間接頭辞を返します。デフォルトの名前空間接頭辞は、putNamespacePrefix メソッドによって明示的に設定されていない、すべての名前空間 URI 用の接頭辞です。

戻り値:

デフォルトの名前空間接頭辞、または設定されたものがない場合は null

関連項目:

setDefaultNamespacePrefix(String)

setDefaultNamespacePrefix

void setDefaultNamespacePrefix(String defaultPrefix)

デフォルトの名前空間接頭辞を設定します。これは、putNamespacePrefix メソッドによって明示的に設定されていない、すべての名前空間 URI 用の名前空間接頭辞を設定します。

パラメータ:

defaultPrefix - デフォルトの名前空間接頭辞、または現在の設定を削除する場合は null。空の文字列 ("") を指定すると、接頭辞をバインドしません。

関連項目:

getDefaultNamespacePrefix()

setProperty

Object setProperty(String name,
                   Object value)

指定したプロパティーを設定します。

パラメータ:

name - プロパティーの名前

value - 設定するプロパティーの値

戻り値:

指定されたプロパティーの以前の値、または 値がなかった場合は null

例外:

NullPointerException - name が null の場合

関連項目:

getProperty(String)

getProperty

Object getProperty(String name)

指定されたプロパティーの値を返します。

パラメータ:

name - プロパティーの名前

戻り値:

指定されたプロパティーの現在の値、または 値がない場合は null

例外:

NullPointerException - name が null の場合

関連項目:

setProperty(String, Object)

get

Object get(Object key)

このコンテキストが指定されたキーにマップされる値を返します。 　

つまり、このコンテキストに (key==null ? k==null :key.equals(k)) という条件で、キー k から値 v へのマッピングが含まれる場合、このメソッドは v を返します。 含まれない場合は null を返します。このようなマッピングが 1 つだけあります。 　

このメソッドは、このコンテキストが使用される暗号化処理に固有である、任意の情報を取得するのに便利です。

パラメータ:

key - 関連付けられた値が返されるキー

戻り値:

このコンテキストが、指定されたキーにマッピングしている値。 または、キーのマッピングがない場合は null

関連項目:

put(Object, Object)

put

Object put(Object key,
           Object value)

このコンテキストで、指定された値を指定されたキーに関連付けます。コンテキストにすでにこのキーに対するマッピングがある場合、古い値は指定された値に置き換えられます。 　

このメソッドは、このコンテキストが使用される暗号化処理に固有である、任意の情報を格納するのに便利です。

パラメータ:

key - 指定される値が関連付けられるキー

value - 指定されるキーに関連付けられる値

戻り値:

キーに関連付けられた以前の値または、キーのマッピングがない場合は null

例外:

IllegalArgumentException - このキーまたは値の一部の特性のために このコンテキストに格納できない場合

関連項目:

get(Object)