Module java.base

软件包 java.security.cert

Class CertPathValidatorException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.security.GeneralSecurityException

java.security.cert.CertPathValidatorException

All Implemented Interfaces:

Serializable

public class CertPathValidatorException
extends GeneralSecurityException

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

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

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

并发访问

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

从以下版本开始：

1.4

另请参见：

CertPathValidator ， Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	描述
static class	CertPathValidatorException.BasicReason	BasicReason列举了任何类型的认证路径可能无效的潜在原因。
static interface	CertPathValidatorException.Reason	验证算法失败的原因。

构造方法摘要

构造方法

Constructor	描述
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 ，它包装指定的throwable。

方法摘要

Modifier and Type	方法	描述
CertPath	getCertPath()	返回在抛出异常时验证的认证路径。
int	getIndex()	返回导致异常抛出的证书路径中的证书的索引。
CertPathValidatorException.Reason	getReason()	返回验证失败的原因。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from class 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 ，它包装指定的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 - 如果 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中的证书列表为零。

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中的证书列表为零。 如果没有设置索引，则返回-1。

结果

已设置的索引，如果没有设置则为-1

getReason

public CertPathValidatorException.Reason getReason()

返回验证失败的原因。 原因与getIndex()返回证书的索引有关。

结果

验证失败的原因，或 BasicReason.UNSPECIFIED如果没有指定原因

从以下版本开始：

1.7