Module  java.base
软件包  java.security.cert

Class CertPathValidatorException

  • All Implemented Interfaces:
    Serializable


    public class CertPathValidatorException
    extends GeneralSecurityException
    表示验证认证路径时遇到的各种问题之一的异常。

    A CertPathValidatorException提供对包装异常的支持。 getCause方法返回引发此异常抛出的throwable(如果有)。

    A CertPathValidatorException还可以包括在抛出异常时验证的认证路径,导致异常引发的认证路径中的证书的索引以及导致失败的原因。 使用getCertPathgetIndex ,并getReason方法来获取这些信息。

    并发访问

    除非另有说明,否则此类中定义的方法不是线程安全的。 需要同时访问单个对象的多个线程应在其间同步并提供必要的锁定。 每个操作单独对象的多个线程不需要同步。

    从以下版本开始:
    1.4
    另请参见:
    CertPathValidatorSerialized Form
    • 构造方法详细信息

      • CertPathValidatorException

        public CertPathValidatorException​()
        创建一个 CertPathValidatorException没有详细消息。
      • CertPathValidatorException

        public CertPathValidatorException​(String msg)
        使用给定的详细信息创建一个CertPathValidatorException 详细信息是描述这个特殊异常的String
        参数
        msg - 详细信息
      • CertPathValidatorException

        public CertPathValidatorException​(Throwable cause)
        创建一个CertPathValidatorException ,它包装指定的throwable。 这允许将任何异常转换为CertPathValidatorException ,同时保留关于包装异常的信息,这可能对调试很有用。 详细消息设置为( cause==null ? null : cause.toString() )(其通常包含原因的类和详细消息)。
        参数
        cause - 原因(保存以供getCause()方法稍后检索)。 (A null值是允许的,并且表示原因不存在或未知。)
      • CertPathValidatorException

        public CertPathValidatorException​(String msg,
                                          Throwable cause)
        创建一个 CertPathValidatorException具有指定的详细信息和原因。
        参数
        msg - 详细信息
        cause - 原因(保存以供getCause()方法后续检索)。 (允许A null值,并表示原因不存在或未知。)
      • CertPathValidatorException

        public CertPathValidatorException​(String msg,
                                          Throwable cause,
                                          CertPath certPath,
                                          int index)
        使用指定的详细消息,原因,认证路径和索引创建 CertPathValidatorException
        参数
        msg - 详细信息(或 null如果没有)
        cause - 原因(或 null如果没有)
        certPath - 遇到错误时验证路径
        index - 导致错误的认证路径中的证书索引(如果不适用,则为-1)。 请注意, CertPath中的证书列表为零。
        异常
        IndexOutOfBoundsException - 如果索引超出范围 (index < -1 || (certPath != null && index >= certPath.getCertificates().size())
        IllegalArgumentException - 如果 certPathnullindex不是-1
      • CertPathValidatorException

        public CertPathValidatorException​(String msg,
                                          Throwable cause,
                                          CertPath certPath,
                                          int index,
                                          CertPathValidatorException.Reason reason)
        使用指定的详细信息,原因,认证路径,索引和原因创建 CertPathValidatorException
        参数
        msg - 详细信息(或 null如果没有)
        cause - 原因(或 null如果没有)
        certPath - 当遇到错误时正在验证的认证路径
        index - 导致错误的认证路径中的证书索引(或-1(如果不适用))。 请注意, CertPath中的证书列表为零。
        reason - 验证失败的原因
        异常
        IndexOutOfBoundsException - 如果索引超出范围 (index < -1 || (certPath != null && index >= certPath.getCertificates().size())
        IllegalArgumentException - 如果 certPathnullindex不是-1
        NullPointerException - 如果 reasonnull
        从以下版本开始:
        1.7
    • 方法详细信息

      • getCertPath

        public CertPath getCertPath​()
        返回在抛出异常时验证的认证路径。
        结果
        CertPath (或当抛出异常正被验证的 null如果未指定)
      • getIndex

        public int getIndex​()
        返回导致异常抛出的证书路径中的证书的索引。 请注意, CertPath中的证书列表为零。 如果没有设置索引,则返回-1。
        结果
        已设置的索引,如果没有设置则为-1
      • getReason

        public CertPathValidatorException.Reason getReason​()
        返回验证失败的原因。 原因与getIndex()返回证书的索引有关。
        结果
        验证失败的原因,或 BasicReason.UNSPECIFIED如果没有指定原因
        从以下版本开始:
        1.7