public abstract class CertStoreSpi extends Object
CertStoreクラスのサービス・プロバイダ・インタフェース (SPI)です。 CertStoreのすべての実装には、このCertStoreSpiクラスを拡張して、CertStoreParametersタイプの引数を1つ持つコンストラクタを提供し、すべてのメソッドを実装するクラス(SPIクラス)が含まれていなければいけません。 一般に、このクラスのインスタンスには、CertStoreクラスを介してアクセスする必要があります。 詳細は、「Java暗号化アーキテクチャ」を参照してください。
並行アクセス
すべてのCertStoreSpiオブジェクトのpublicメソッドは、スレッドに対して安全である必要があります。 つまり、単一の(または複数の) CertStoreSpiオブジェクト上で、複数のスレッドがこれらのメソッドを並行して呼び出しても、悪影響はありません。 これにより、たとえばCertPathBuilderは、CRLを検索しながら同時にほかの証明書を検索できます。
簡単なCertStoreSpiの実装では、synchronizedキーワードをengineGetCertificatesメソッドとengineGetCRLsメソッドに追加することで、スレッドに対して安全であることが保証されます。 高度な実装では、真の並行アクセスが可能になります。
| コンストラクタ | 説明 |
|---|---|
CertStoreSpi(CertStoreParameters params) |
唯一のコンストラクタです。
|
| 修飾子と型 | メソッド | 説明 |
|---|---|---|
abstract Collection<? extends Certificate> |
engineGetCertificates(CertSelector selector) |
指定したセレクタに一致する
CertificateのCollectionを返します。 |
abstract Collection<? extends CRL> |
engineGetCRLs(CRLSelector selector) |
指定したセレクタに一致する
CRLのCollectionを返します。 |
public CertStoreSpi(CertStoreParameters params) throws InvalidAlgorithmParameterException
params - 初期化パラメータ。nullも可InvalidAlgorithmParameterException - 初期化パラメータがこのCertStoreSpiに対して不適切な場合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 - 例外が発生する場合public abstract Collection<? extends CRL> engineGetCRLs(CRLSelector selector) throws CertStoreException
CRLのCollectionを返します。 セレクタに一致するCRLがない場合は、空のCollectionが返されます。
CertStoreのタイプによっては、セレクタに一致するCRLのすべてが結果として得られるCollectionに含まれないことがあります。 たとえば、LDAP CertStoreは、ディレクトリ内のすべてのエントリを検索しない場合があります。 代わりに、検索するCRLが含まれると考えられるエントリに絞って検索します。
CertStoreの実装の中には、CRLを見つけるための特定の条件を含むnull以外のCRLSelectorが提供されないかぎり、CertStoreExceptionをスローするものがあります(特にLDAP CertStore)。 発行者の名前やチェック対象の証明書は特に役立ちます。
selector - 返されるCRLを選択するために使用するCRLSelector。 nullを指定すると、サポートされている場合はすべてのCRLが返される CRLのCollection。nullにはならないCertStoreException - 例外が発生する場合 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。