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
- 関連項目:
-
ネストされたクラスのサマリー
ネストされたクラス修飾子と型クラス説明static enum
BasicReasonは、任意のタイプの証明書パスが無効になる可能性がある潜在的な理由を列挙します。static interface
検査アルゴリズムが失敗した理由です。 -
コンストラクタのサマリー
コンストラクタコンストラクタ説明詳細メッセージを持たないCertPathValidatorException
を作成します。指定された詳細メッセージを持つ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
を作成します。 -
メソッドのサマリー
修飾子と型メソッド説明例外がスローされたときに検査中だった証明書パスを返します。int
getIndex()
スローされた例外の原因となった証明書パスの証明書のインデックスを返します。検証が失敗した理由を返します。クラス 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
指定した詳細メッセージと原因を持つCertPathValidatorException
を作成します。- パラメータ:
msg
- 詳細メッセージcause
- 原因(あとでgetCause()
メソッドで取得できるように保存される)。 (null
値が許可されており、原因が存在しないか不明であることを示す。)
-
CertPathValidatorException
指定した詳細メッセージ、原因、証明書パス、およびインデックスを持つ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
-