|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
java.lang.Object | +--java.security.cert.CertPathBuilder
証明書パス (証明書チェインとも呼ばれる) を構築するためのクラスです。
このクラスでは、「Java 暗号化アーキテクチャ」で説明されているような、プロバイダベースのアーキテクチャを使用します。CertPathBuilder を作成するには、static getInstance メソッドのうちの 1 つを呼び出して、作成する CertPathBuilder のアルゴリズム名とプロバイダ名 (省略可能) を渡します。
CertPathBuilder オブジェクトが作成されると、build メソッドを呼び出してアルゴリズムに特定のパラメータセットを渡すことで、証明書パスが構築されます。証明書パスの構築に成功すると、CertPathBuilderResult インタフェースを実装するオブジェクトにその結果 (構築した CertPath を含む) が返されます。
並行アクセス
このクラスの static メソッドは、スレッドセーフであることが保証されています。このクラスで定義されている static メソッドは、悪影響を与えることなく、複数スレッドが並行して呼び出すことができます。
しかしこのことは、このクラスで定義されている非 static メソッドには当てはまりません。特定のプロバイダで特に説明のない限り、単一 CertPathBuilder インスタンスに並行してアクセスする必要のある複数スレッドは、スレッド間で同期をとり、必要に応じてロックしなければなりません。異なる CertPathBuilder インスタンスを操作する複数スレッド間では、同期をとる必要はありません。
CertPath| コンストラクタの概要 | |
protected |
CertPathBuilder(CertPathBuilderSpi builderSpi,
Provider provider,
String algorithm)
指定されたアルゴリズムの CertPathBuilder オブジェクトを作成し、指定されたプロバイダの実装 (SPI オブジェクト) をそこにカプセル化します。 |
| メソッドの概要 | |
CertPathBuilderResult |
build(CertPathParameters params)
指定したアルゴリズムのパラメータセットを使用して、証明書パスを構築しようとします。 |
String |
getAlgorithm()
この CertPathBuilder のアルゴリズム名を返します。 |
static String |
getDefaultType()
Java セキュリティプロパティファイルに指定されているデフォルトの CertPathBuilder タイプを返します。 |
static CertPathBuilder |
getInstance(String algorithm)
指定したアルゴリズムを実装する CertPathBuilder オブジェクトを返します。
|
static CertPathBuilder |
getInstance(String algorithm,
Provider provider)
指定したプロバイダが提供する、指定したアルゴリズムを実装する CertPathBuilder オブジェクトを返します。 |
static CertPathBuilder |
getInstance(String algorithm,
String provider)
指定したプロバイダが提供する、指定したアルゴリズムを実装する CertPathBuilder オブジェクトを返します。 |
Provider |
getProvider()
この CertPathBuilder のプロバイダを返します。 |
| クラス java.lang.Object から継承したメソッド |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| コンストラクタの詳細 |
protected CertPathBuilder(CertPathBuilderSpi builderSpi,
Provider provider,
String algorithm)
CertPathBuilder オブジェクトを作成し、指定されたプロバイダの実装 (SPI オブジェクト) をそこにカプセル化します。
builderSpi - プロバイダの実装provider - プロバイダalgorithm - アルゴリズム名| メソッドの詳細 |
public static CertPathBuilder getInstance(String algorithm)
throws NoSuchAlgorithmException
CertPathBuilder オブジェクトを返します。
指定した CertPathBuilder アルゴリズムの実装をデフォルトのプロバイダパッケージが提供している場合は、その実装を含む CertPathBuilder のインスタンスが返されます。デフォルトパッケージで目的のアルゴリズムが提供されていない場合には、他のパッケージが検索されます。
algorithm - 要求した CertPathBuilder アルゴリズムの名前
CertPathBuilder オブジェクト
NoSuchAlgorithmException - 要求されるアルゴリズムが、デフォルトのプロバイダパッケージにも、検索したほかのプロバイダパッケージにもない場合
public static CertPathBuilder getInstance(String algorithm,
String provider)
throws NoSuchAlgorithmException,
NoSuchProviderException
CertPathBuilder オブジェクトを返します。
algorithm - 要求した CertPathBuilder アルゴリズムの名前provider - プロバイダ名
CertPathBuilder オブジェクト
NoSuchAlgorithmException - 指定されたプロバイダに要求したアルゴリズムがない場合
NoSuchProviderException - プロバイダが設定されていない場合
IllegalArgumentException - provider が null の場合
public static CertPathBuilder getInstance(String algorithm,
Provider provider)
throws NoSuchAlgorithmException
CertPathBuilder オブジェクトを返します。注: provider は登録されている必要はありません。
algorithm - 要求した CertPathBuilder アルゴリズムの名前provider - プロバイダ
CertPathBuilder オブジェクト
NoSuchAlgorithmException - 指定されたプロバイダに要求したアルゴリズムがない場合
IllegalArgumentException - provider が null の場合public final Provider getProvider()
CertPathBuilder のプロバイダを返します。
CertPathBuilder のプロバイダpublic final String getAlgorithm()
CertPathBuilder のアルゴリズム名を返します。
CertPathBuilder のアルゴリズム名
public final CertPathBuilderResult build(CertPathParameters params)
throws CertPathBuilderException,
InvalidAlgorithmParameterException
params - アルゴリズムのパラメータ
CertPathBuilderException - 指定したパラメータを満たす証明書パスを構築できなかった場合
InvalidAlgorithmParameterException - 指定されたパラメータがこの CertPathBuilder に対して不適切な場合public static final String getDefaultType()
CertPathBuilder タイプを返します。デフォルトの CertPathBuilder タイプを示すプロパティがない場合は、文字列「PKIX」を返します。Java セキュリティプロパティファイルは、<JAVA_HOME>/lib/security/java.security というファイルにあります。<JAVA_HOME> は、SDK がインストールされているディレクトリです。
デフォルトの CertPathBuilder タイプを使用するのは、アプリケーションで getInstance メソッドを呼び出すときにハードコードされたタイプを使用しない場合、およびユーザが独自のタイプを指定しないときにデフォルトのタイプを提供する場合です。
デフォルトの CertPathBuilder タイプを変更するには、Java セキュリティプロパティファイルの certpathbuilder.type セキュリティプロパティの値を目的のタイプに設定します。
CertPathBuilder タイプ。プロパティが存在しない場合は、文字列「PKIX」
|
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.