モジュール java.base

パッケージ 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.Objectから継承されたメソッド

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

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

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

コンストラクタの詳細

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