クラス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
関連項目:

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

    ネストされたクラス
    修飾子と型
    クラス
    説明
    static enum 
    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()
    検証が失敗した理由を返します。

    Throwableクラスで宣言されたメソッド

    addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
    修飾子と型
    メソッド
    説明
    final void
    addSuppressed(Throwable exception)
    この例外を提供する目的で抑制された例外に、指定された例外を追加します。
    Throwable
    fillInStackTrace()
    実行スタック・トレースを埋め込みます。
    Throwable
    getCause()
    このスロー可能オブジェクトの原因を返しますが、原因が存在しないか不明な場合はnullを返します。
    String
    getLocalizedMessage()
    このスロー可能オブジェクトの、ローカライズされた記述を作成します。
    String
    getMessage()
    このスロー可能オブジェクトの詳細メッセージ文字列を返します。
    StackTraceElement[]
    getStackTrace()
    Throwable.printStackTrace()によって出力されるスタック・トレース情報にプログラムでアクセスできるようにします。
    final Throwable[]
    getSuppressed()
    この例外を提供する目的で(通常try-with-resources文によって)抑制された例外をすべて含む配列を返します。
    Throwable
    initCause(Throwable cause)
    このスロー可能オブジェクトの原因を、指定された値に初期化します。
    void
    printStackTrace()
    このスロー可能オブジェクトおよびそのバックトレースを標準エラー・ストリームに出力します。
    void
    printStackTrace(PrintStream s)
    このスロー可能オブジェクトとそのバックトレースを指定された印刷ストリームに出力します。
    void
    printStackTrace(PrintWriter s)
    このスロー可能オブジェクトとそのバックトレースを指定されたプリント・ライターに出力します。
    void
    setStackTrace(StackTraceElement[] stackTrace)
    Throwable.getStackTrace()によって返され、Throwable.printStackTrace()と関連メソッドによって出力される、スタック・トレース要素を設定します。
    String
    toString()
    このスロー可能オブジェクトの短い記述を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • 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