java.security.cert
クラス CertStoreSpi

java.lang.Object
  |
  +--java.security.cert.CertStoreSpi

public abstract class CertStoreSpi

extends Object

CertStore クラスの Service Provider Interface (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	engineGetCertificates(CertSelector selector) 指定したセレクタに一致する Certificate の Collection を返します。
abstract Collection	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 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 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 - 例外が発生する場合