JavaTM 2 Platform
Standard Ed. 5.0

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 を使用します。

並行アクセス

特に断らないかぎり、このクラスで定義されているメソッドはスレッドに対して安全ではありません。単一のオブジェクトに並行アクセスする必要のある複数スレッドは、スレッド間で同期をとり、必要に応じてロックしなければなりません。異なるオブジェクトを操作する複数スレッドでは、同期をとる必要はありません。

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

コンストラクタの概要
CertPathValidatorException()
          詳細メッセージを指定しないで CertPathValidatorException を作成します。
CertPathValidatorException(String msg)
          指定された詳細メッセージを持つ CertPathValidatorException を作成します。
CertPathValidatorException(String msg, Throwable cause)
          指定した詳細メッセージと原因を持つ CertPathValidatorException を作成します。
CertPathValidatorException(String msg, Throwable cause, CertPath certPath, int index)
          指定した詳細メッセージ、原因、証明書パス、およびインデックスを持つ CertPathValidatorException を作成します。
CertPathValidatorException(Throwable cause)
          指定したスロー可能なオブジェクトをラップする CertPathValidatorException を作成します。
 
メソッドの概要
 CertPath getCertPath()
          例外がスローされたときに検査中だった証明書パスを返します。
 int getIndex()
          スローされた例外の原因となった証明書パスの証明書のインデックスを返します。
 
クラス java.lang.Throwable から継承されたメソッド
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, 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 - certPathnull であり、かつ index が -1 ではない場合
メソッドの詳細

getCertPath

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

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

getIndex

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

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

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。