java.security.cert

クラス CertPathValidatorException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.security.GeneralSecurityException

java.security.cert.CertPathValidatorException

すべての実装されたインタフェース:

Serializable

public class CertPathValidatorException
extends GeneralSecurityException

証明書パスの妥当性を検査するときに検出されるさまざまな問題の 1 つを表す例外です。

CertPathValidatorException ではラップしている例外をサポートしています。getCause メソッドは、この例外がスローされる原因となったスロー可能オブジェクトを返します (存在する場合)。

CertPathValidatorException には、例外がスローされたときに検査中だった証明書パスと、例外がスローされる原因となった証明書パスの証明書のインデックス、障害の原因となった理由も含まれます。この情報を取得するには、getCertPath、getIndex、および getReason メソッドを使用します。

並行アクセス

特に断らないかぎり、このクラスで定義されているメソッドはスレッドセーフではありません。単一のオブジェクトに並行アクセスする必要のある複数スレッドは、スレッド間で同期をとり、必要に応じてロックする必要があります。複数のスレッドがそれぞれ個別のオブジェクトを処理する場合、それらのスレッドは同期する必要はありません。

導入されたバージョン:

1.4

関連項目:

CertPathValidator, 直列化された形式

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
static class	CertPathValidatorException.BasicReason BasicReason は、任意のタイプの証明書パスが無効になる可能性がある潜在的な理由を列挙します。
static interface	CertPathValidatorException.Reason 検査アルゴリズムが失敗した理由です。

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
CertPathValidatorException() 詳細メッセージを持たない CertPathValidatorException を作成します。
CertPathValidatorException(String msg) 指定された詳細メッセージを持つ CertPathValidatorException を作成します。
CertPathValidatorException(String msg, Throwable cause) 指定した詳細メッセージと原因を持つ CertPathValidatorException を作成します。
CertPathValidatorException(String msg, Throwable cause, CertPath certPath, int index) 指定した詳細メッセージ、原因、証明書パス、およびインデックスを持つ CertPathValidatorException を作成します。
CertPathValidatorException(String msg, Throwable cause, CertPath certPath, int index, CertPathValidatorException.Reason reason) 指定した詳細メッセージ、原因、証明書パス、インデックス、および理由を持つ CertPathValidatorException を作成します。
CertPathValidatorException(Throwable cause) 指定したスロー可能なオブジェクトをラップする CertPathValidatorException を作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
CertPath	getCertPath() 例外がスローされたときに検査中だった証明書パスを返します。
int	getIndex() スローされた例外の原因となった証明書パスの証明書のインデックスを返します。
CertPathValidatorException.Reason	getReason() 検証が失敗した理由を返します。

クラス java.lang.Throwable から継承されたメソッド

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

CertPathValidatorException

public CertPathValidatorException()

詳細メッセージを持たない CertPathValidatorException を作成します。

CertPathValidatorException

public CertPathValidatorException(String msg)

指定された詳細メッセージを持つ CertPathValidatorException を作成します。詳細メッセージとは、この例外を記述する String です。

パラメータ:

msg - 詳細メッセージ

CertPathValidatorException

public CertPathValidatorException(Throwable cause)

指定したスロー可能なオブジェクトをラップする CertPathValidatorException を作成します。これによりどんな例外でも、デバッグ時に役立つラップされた例外の情報を保持しながら、CertPathValidatorException に変換できます。詳細メッセージは (cause==null ? null : cause.toString() ) に設定されます (通常、原因となったクラスと詳細メッセージを含みます)。

パラメータ:

cause - 原因 (あとで getCause() メソッドで取得できるように保存される)。(null 値が許可されており、原因が存在しないか不明であることを示す。)

CertPathValidatorException

public CertPathValidatorException(String msg,
                          Throwable cause)

指定した詳細メッセージと原因を持つ CertPathValidatorException を作成します。

パラメータ:

msg - 詳細メッセージ

cause - 原因 (あとで getCause() メソッドで取得できるように保存される)。(null 値が許可されており、原因が存在しないか不明であることを示す。)

CertPathValidatorException

public CertPathValidatorException(String msg,
                          Throwable cause,
                          CertPath certPath,
                          int index)

指定した詳細メッセージ、原因、証明書パス、およびインデックスを持つ CertPathValidatorException を作成します。

パラメータ:

msg - 詳細メッセージ。存在しない場合は null

cause - 原因。存在しない場合は null

certPath - エラーが検出されたときに検査中だった証明書パス

index - エラーの原因となった証明書パスの証明書のインデックス。妥当でない場合は -1。CertPath の証明書リストは 0 から始まることに注意してください。

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < -1 || (certPath != null && index >= certPath.getCertificates().size())

IllegalArgumentException - certPath が null であり、かつ index が -1 でない場合

CertPathValidatorException

public CertPathValidatorException(String msg,
                          Throwable cause,
                          CertPath certPath,
                          int index,
                          CertPathValidatorException.Reason reason)

指定した詳細メッセージ、原因、証明書パス、インデックス、および理由を持つ CertPathValidatorException を作成します。

パラメータ:

msg - 詳細メッセージ。存在しない場合は null

cause - 原因。存在しない場合は null

certPath - エラーが検出されたときに検査中だった証明書パス

index - エラーの原因となった証明書パスの証明書のインデックス。妥当でない場合は -1。CertPath の証明書リストは 0 から始まることに注意してください。

reason - 検証が失敗した理由

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < -1 || (certPath != null && index >= certPath.getCertificates().size())

IllegalArgumentException - certPath が null であり、かつ index が -1 でない場合

NullPointerException - reason が null である場合

導入されたバージョン:

1.7

メソッドの詳細

getCertPath

public CertPath getCertPath()

例外がスローされたときに検査中だった証明書パスを返します。

戻り値:

例外がスローされたときに検査中だった CertPath。指定されていない場合は null

getIndex

public int getIndex()

スローされた例外の原因となった証明書パスの証明書のインデックスを返します。CertPath の証明書リストは 0 から始まることに注意してください。インデックスが設定されていない場合は、-1 が返されます。

戻り値:

設定されているインデックス。設定されていない場合は -1

getReason

public CertPathValidatorException.Reason getReason()

検証が失敗した理由を返します。理由は、getIndex() によって返される証明書のインデックスに関連付けられます。

戻り値:

検証が失敗した理由。理由が指定されない場合は BasicReason.UNSPECIFIED

導入されたバージョン:

1.7