Класс CertPathValidatorException

java.lang.Object
- java.lang.Throwable
- - java.lang.Exception
  - - java.security.GeneralSecurityException
    - - java.security.cert.CertPathValidatorException

Все реализованные интерфейсы:: Serializable

public class CertPathValidatorException
extends GeneralSecurityException

Исключение, указывающее на одну из различных проблем, возникших при проверке цепочки сертификатов.

Класс предоставляет поддержку для обертывания исключений. Метод getCause возвращает исключение, если таковое имело место, которое вызвало данное исключение.

Исключение может также содержать цепочку сертификатов, которая проверялась при возникновении исключения, индекс сертификата в цепочке сертификатов, вызвавший исключение, и причину сбоя. Используйте методы getCertPath, getIndex и getReason, чтобы получить эту информацию.

Доступ к данным в нескольких потоках

Если не указано иное, методы, определённые в этом классе, не потокобезопасны. Несколько потоков, которые должны одновременно обращаться к одному объекту, должны синхронизироваться между собой и обеспечить необходимую блокировку. Несколько потоков, манипулирующих различными объектами, синхронизироваться не требуется.

С тех пор как:: 1.4
См. также:: CertPathValidator, Формат сериализации

Вложенные классы

Модификатор и тип	Класс	Описание
`static class`	`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()`	Возвращает причину сбоя проверки.

Методы, объявленные в классе java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, 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 нумеруется с нуля.
Исключения:: 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