compact3

javax.xml.crypto

クラスKeySelector

java.lang.Object

javax.xml.crypto.KeySelector

public abstract class KeySelector
extends Object

KeyInfoオブジェクトに格納されるデータを使用して、鍵を検索して返すセレクタです。このクラスの実装の例は、KeyInfoに格納される情報に一致する信頼できる鍵でKeyStoreを検索する場合です。

返された鍵が信頼できるかどうか、およびその検出にメカニズムが使用されるかどうかは、実装に固有となります。

導入されたバージョン:

1.6

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
static class	KeySelector.Purpose 選択される鍵の目的です。

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	KeySelector() デフォルトは引数のないコンストラクタで、サブクラスによる呼出しのみを想定しています。

メソッドのサマリー

修飾子と型	メソッドと説明
abstract KeySelectorResult	select(KeyInfo keyInfo, KeySelector.Purpose purpose, AlgorithmMethod method, XMLCryptoContext context) 指定された制約を満たす鍵の検索を試みます。
static KeySelector	singletonKeySelector(Key key) 渡されるKeyInfoに関係なく、常に指定した鍵を選択するKeySelectorを返します。

クラス java.lang.Objectから継承されたメソッド

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

コンストラクタの詳細

KeySelector

protected KeySelector()

デフォルトは引数のないコンストラクタで、サブクラスによる呼出しのみを想定しています。

メソッドの詳細

select

public abstract KeySelectorResult select(KeyInfo keyInfo,
                                         KeySelector.Purpose purpose,
                                         AlgorithmMethod method,
                                         XMLCryptoContext context)
                                  throws KeySelectorException

指定された制約を満たす鍵の検索を試みます。

パラメータ:

keyInfo - KeyInfo (nullも可能)

purpose - 鍵の目的(KeySelector.Purpose.SIGN、KeySelector.Purpose.VERIFY、KeySelector.Purpose.ENCRYPT、またはKeySelector.Purpose.DECRYPT)

method - この鍵が使用される対象のアルゴリズム・メソッド。アルゴリズムと互換性があり、指定したアルゴリズムの制約を満たす鍵だけが返される。

context - 適切な鍵の検索に役立つ情報が含まれている場合のあるXMLCryptoContext。この鍵セレクタがRetrievalMethod型の解決をサポートしている場合は、コンテキストのbaseURIおよびdereferencerパラメータ(指定されている場合)を使ってURIの解決と間接参照が行われる。

戻り値:

鍵セレクタの結果

例外:

KeySelectorException - 鍵の検索を試みている途中で例外的な状況が発生した場合。鍵を検索できないことが例外であると見なされることはない(その場合はnullが返される)。ただし、KeySelectorが可能性のある鍵を検索できなくなるエラー状況(ネットワーク通信障害など)は例外と見なされる。

ClassCastException - methodのデータ型がこの鍵セレクタによってサポートされていない場合

singletonKeySelector

public static KeySelector singletonKeySelector(Key key)

渡されるKeyInfoに関係なく、常に指定した鍵を選択するKeySelectorを返します。

パラメータ:

key - 鍵セレクタに格納される唯一の鍵

戻り値:

常に指定した鍵を選択する鍵セレクタ

例外:

NullPointerException - keyがnullである場合