compact1, compact2, compact3

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

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

一个CertPathValidatorException提供异常的包装支持。如果有任何错误，返回getCause方法，造成这种异常被抛出。

一个CertPathValidatorException可能还包括证书路径被验证时抛出异常，在导致引发异常的认证证书路径的指标，而原因导致失败。使用getCertPath，getIndex，和getReason方法检索此信息。

并发访问

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

从以下版本开始：

一点四

另请参见：

CertPathValidator， Serialized Form

Nested Class Summary

Nested Classes

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

构造方法摘要

构造方法

Constructor and Description
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包装指定的时间。

方法摘要

Modifier and Type	Method and Description
CertPath	getCertPath() 返回正在被抛出的异常时正在验证的证书路径。
int	getIndex() 返回引发要引发的异常的证书路径中的证书的索引。
CertPathValidatorException.Reason	getReason() 返回验证失败的原因。

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

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证书列表是零基础。

异常

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

如果是 null reason NullPointerException

从以下版本开始：

一点七

方法详细信息

getCertPath

public CertPath getCertPath()

返回正在被抛出的异常时正在验证的证书路径。

结果

的 CertPath被验证时抛出异常（或 null如果不指定）

getIndex

public int getIndex()

返回引发要引发的异常的证书路径中的证书的索引。注意，在 CertPath证书列表是零基础。如果没有设置索引，-返回1。

结果

已设置的索引，或-如果没有已设置的索引

getReason

public CertPathValidatorException.Reason getReason()

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

结果

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

从以下版本开始：

一点七