モジュール java.base
パッケージ java.security.cert

クラスCertPathValidatorException

  • すべての実装されたインタフェース:
    Serializable
    public class CertPathValidatorException
extends GeneralSecurityException
    証明書パスの妥当性を検査するときに検出されるさまざまな問題の1つを表す例外です。

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

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

    並行アクセス

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

    導入されたバージョン:
    1.4
    関連項目:
    CertPathValidator, 直列化された形式

    • コンストラクタの詳細

      • 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