CertStoreSpi (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.security.cert
クラス CertStoreSpi

java.lang.Object
  java.security.cert.CertStoreSpi

public abstract class CertStoreSpi
extends Object
extends Object

CertStore クラスのサービスプロバイダインタフェース (SPI) です。CertStore のすべての実装には、この CertStorerSpi クラスを拡張して、CertStoreParameters 型の引数を 1 つ持つコンストラクタを提供し、すべてのメソッドを実装するクラス (SPI クラス) が含まれていなければいけません。一般に、このクラスには、CertStore クラスを介してアクセスする必要があります。詳細は、「Java 暗号化アーキテクチャー」を参照してください。

並行アクセス

CertStoreSpi オブジェクトの public メソッドは、スレッドに対して安全である必要があります。つまり、それらの public メソッドは、悪影響を与えることなく、単一 CertStoreSpi オブジェクト (または 1 つ以上) 上で複数スレッドが並行して呼び出すことができます。これにより、たとえば CertPathBuilder は、CRL を検索しながら、同時に他の証明書を検索することができます。

簡単な CertStoreSpi の実装では、synchronized キーワードを engineGetCertificates メソッドと engineGetCRLs メソッドに追加することで、スレッドに対して安全であることが保証されます。高度な実装では、真の並行アクセスが可能になります。

導入されたバージョン:: 1.4

コンストラクタの概要
`CertStoreSpi(CertStoreParameters params)` 唯一のコンストラクタです。

メソッドの概要
`abstract Collection<? extends Certificate>`	`engineGetCertificates(CertSelector selector)` 指定したセレクタに一致する `Certificate` の `Collection` を返します。
`abstract Collection<? extends CRL>`	`engineGetCRLs(CRLSelector selector)` 指定したセレクタに一致する `CRL` の `Collection` を返します。

クラス java.lang.Object から継承されたメソッド
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

コンストラクタの詳細

CertStoreSpi

public CertStoreSpi(CertStoreParameters params)
             throws InvalidAlgorithmParameterException

唯一のコンストラクタです。

パラメータ:: params - 初期化パラメータ。null も可
例外:: InvalidAlgorithmParameterException - 初期化パラメータがこの CertStoreSpi に対して不適切な場合

メソッドの詳細

engineGetCertificates

public abstract Collection<? extends Certificate> engineGetCertificates(CertSelector selector)
                                                                 throws CertStoreException

指定したセレクタに一致する Certificate の Collection を返します。セレクタに一致する Certificate がない場合は、空の Collection が返されます。

CertStore の型によっては、セレクタに一致する Certificate のすべてが結果として得られる Collection に含まれないことがあります。たとえば、LDAP CertStore は、ディレクトリ内のすべてのエントリを検索しない場合があります。代わりに、検索する Certificate が含まれると考えられるエントリに絞って検索します。

CertStore の中には、証明書を見つけるための特定の条件を含む非 null の CertSelector が提供されないかぎり、CertStoreException をスローするものがあります (特に LDAP CertStore)。発行者や被認証者の名前は特に役立つ条件となります。

パラメータ:: selector - 返される Certificate を選択するために使用する CertSelector。null を指定すると、サポートされている場合はすべての Certificate が返される
戻り値:: 指定されたセレクタに一致する Certificate の Collection。null にはならない
例外:: CertStoreException - 例外が発生する場合

engineGetCRLs

public abstract Collection<? extends CRL> engineGetCRLs(CRLSelector selector)
                                                 throws CertStoreException

指定したセレクタに一致する CRL の Collection を返します。セレクタに一致する CRL がない場合は、空の Collection が返されます。

CertStore の型によっては、セレクタに一致する CRL のすべてが結果として得られる Collection に含まれないことがあります。たとえば、LDAP CertStore は、ディレクトリ内のすべてのエントリを検索しない場合があります。代わりに、検索する CRL が含まれると考えられるエントリに絞って検索します。

CertStore の中には、証明書を見つけるための特定の条件を含む非 null の CRLSelector が提供されないかぎり、CertStoreException をスローするものがあります (特に LDAP CertStore)。発行者の名前やチェック対象の証明書は特に役立ちます。

パラメータ:: selector - 返される CRL を選択するために使用する CRLSelector。null を指定すると、サポートされている場合はすべての CRL が返される
戻り値:: 指定されたセレクタに一致する CRL の Collection。null にはならない
例外:: CertStoreException - 例外が発生する場合