JavaTM Platform
Standard Ed. 6

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.SIGNKeySelector.Purpose.VERIFYKeySelector.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 - keynull の場合

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。