|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.security.cert.CertStore
リポジトリから Certificate
と CRL
を取得するクラスです。
このクラスでは、「Java 暗号化アーキテクチャ」で説明されているような、プロバイダベースのアーキテクチャを使用します。CertStore
を作成するには、static getInstance
メソッドのうちの 1 つを呼び出して、作成する CertStore
の型、適用可能な初期化パラメータ、プロバイダ名 (省略可能) を渡します。
CertStore
を作成したら、getCertificates
メソッドと getCRLs
メソッドを呼び出すことで Certificate
と CRL
を取得することができます。
非公開鍵と信頼できる証明書のキャッシュにアクセスする KeyStore
とは異なり、CertStore
は巨大になるおそれのある、信頼されていない証明書と CRL のリポジトリにアクセスするよう設計されています。たとえば、CertStore
の LDAP 実装では、LDAP プロトコルと RFC サービス属性として定義されたスキーマとを使用して、1 つ以上のディレクトリに格納された証明書と CRL へアクセスできます。標準の CertStore
型の詳細については、「Java Certification Path API Programmer's Guide」の付録 A を参照してください。
並行アクセス
CertStore
オブジェクトのすべての public メソッドは、スレッドセーフでなければなりません。つまり、それらの public メソッドは、悪影響を与えることなく、単一 CertStore
オブジェクト (または 1 つ以上) 上で複数スレッドが並行して呼び出すことができます。これにより、たとえば次々と証明書を検索しながら、同時に CertPathBuilder
を使用して CRL を検索することができます。
また、このクラスの static メソッドは、スレッドセーフであることが保証されています。このクラスで定義されている static メソッドは、悪影響を与えることなく、複数スレッドが並行して呼び出すことができます。
コンストラクタの概要 | |
protected |
CertStore(CertStoreSpi storeSpi,
Provider provider,
String type,
CertStoreParameters params)
指定された型の CertStore オブジェクトを作成し、指定されたプロバイダの実装 (SPI オブジェクト) をそこにカプセル化します。 |
メソッドの概要 | |
Collection |
getCertificates(CertSelector selector)
指定したセレクタに一致する Certificate の Collection を返します。 |
CertStoreParameters |
getCertStoreParameters()
CertStore を初期化するためのパラメータを返します。 |
Collection |
getCRLs(CRLSelector selector)
指定したセレクタに一致する CRL の Collection を返します。 |
static String |
getDefaultType()
Java セキュリティプロパティファイルに指定されているデフォルトの CertStore 型を返します。 |
static CertStore |
getInstance(String type,
CertStoreParameters params)
指定した CertStore 型を実装し、指定したパラメータで初期化される CertStore を返します。
|
static CertStore |
getInstance(String type,
CertStoreParameters params,
Provider provider)
指定したプロバイダが提供し、指定したパラメータで初期化される、指定した CertStore を実装する CertStore オブジェクトを返します。 |
static CertStore |
getInstance(String type,
CertStoreParameters params,
String provider)
指定したプロバイダが提供し、指定したパラメータで初期化される、指定した CertStore を実装する CertStore オブジェクトを返します。
|
Provider |
getProvider()
この CertStore のプロバイダを返します。 |
String |
getType()
この CertStore の型を返します。 |
クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
コンストラクタの詳細 |
protected CertStore(CertStoreSpi storeSpi, Provider provider, String type, CertStoreParameters params)
CertStore
オブジェクトを作成し、指定されたプロバイダの実装 (SPI オブジェクト) をそこにカプセル化します。
storeSpi
- プロバイダの実装provider
- プロバイダtype
- 型params
- 初期化パラメータ。null
も可メソッドの詳細 |
public final Collection getCertificates(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 final Collection getCRLs(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
- 例外が発生する場合public static CertStore getInstance(String type, CertStoreParameters params) throws InvalidAlgorithmParameterException, NoSuchAlgorithmException
CertStore
型を実装し、指定したパラメータで初期化される CertStore
を返します。
指定した CertStore
型の実装をデフォルトのプロバイダパッケージが提供している場合は、その実装を含む CertStore
のインスタンスが返されます。デフォルトパッケージで目的の型が提供されていない場合には、他のパッケージが検索されます。
返された CertStore
は指定された CertStoreParameters
を使用して初期化されます。必要なパラメータの型は、CertStore
の型によって異なります。CertStoreParameters
オブジェクトの複製を指定していることに注意してください。
type
- 要求した CertStore
型の名前params
- 初期化パラメータ。null
も可
CertStore
型を実装する CertStore
オブジェクト
NoSuchAlgorithmException
- 要求される型が、デフォルトのプロバイダパッケージにも、検索したほかのプロバイダパッケージにもない場合
InvalidAlgorithmParameterException
- 指定された初期化パラメータがこの CertStore
に対して不適切な場合public static CertStore getInstance(String type, CertStoreParameters params, String provider) throws InvalidAlgorithmParameterException, NoSuchAlgorithmException, NoSuchProviderException
CertStore
を実装する CertStore
オブジェクトを返します。
返された CertStore
は指定された CertStoreParameters
で初期化されます。必要なパラメータの型は、CertStore
の型によって異なります。指定された CertStoreParameters
オブジェクトは複製です。
type
- 要求された CertStore
型params
- 初期化パラメータ。null
も可provider
- プロバイダ名
CertStore
オブジェクト
NoSuchAlgorithmException
- 指定されたプロバイダに要求した型がない場合
InvalidAlgorithmParameterException
- 指定された初期化パラメータがこの CertStore
に対して不適切な場合
NoSuchProviderException
- プロバイダが設定されていない場合
IllegalArgumentException
- provider
が null の場合public static CertStore getInstance(String type, CertStoreParameters params, Provider provider) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException
CertStore
を実装する CertStore
オブジェクトを返します。注: provider
は登録されている必要はありません。
返された CertStore
は指定された CertStoreParameters
で初期化されます。必要なパラメータの型は、CertStore
の型によって異なります。CertStoreParameters
オブジェクトの複製を指定していることに注意してください。
type
- 要求された CertStore
型params
- 初期化パラメータ。null
も可provider
- プロバイダ
CertStore
オブジェクト
NoSuchAlgorithmException
- 指定されたプロバイダに要求した型がない場合
InvalidAlgorithmParameterException
- 指定された初期化パラメータがこの CertStore
に対して不適切な場合
IllegalArgumentException
- provider
が null の場合public final CertStoreParameters getCertStoreParameters()
CertStore
を初期化するためのパラメータを返します。返される前のCertStoreParameters
オブジェクトは複製です。
CertStore
を初期化するパラメータ。null
も可能public final String getType()
CertStore
の型を返します。
CertStore
の型public final Provider getProvider()
CertStore
のプロバイダを返します。
CertStore
のプロバイダpublic static final String getDefaultType()
CertStore
型を返します。デフォルトの CertStore
型を示すプロパティがない場合は、文字列「LDAP」を返します。Java セキュリティプロパティファイルは、<JAVA_HOME>/lib/security/java.security というファイルにあります。<JAVA_HOME> は、SDK がインストールされているディレクトリです。
デフォルトの CertStore
型を使用するのは、アプリケーションで getInstance
メソッドを呼び出すときにハードコードされた型を使用しない場合、およびユーザが独自の型を指定しないときにデフォルトの CertStore
型を提供する場合です。
デフォルトの CertStore
型を変更するには、Java セキュリティプロパティファイルの certstore.type セキュリティプロパティの値を目的の型に設定します。
CertStore
型。プロパティが存在しない場合は、文字列「LDAP」
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.