Класс CertPathValidatorException

java.security.cert.CertPathValidatorException

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

public class CertPathValidatorException extends GeneralSecurityException

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

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

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

Доступность из нескольких потоков

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

С момента:

1.4

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static enum`	`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

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/security/cert/CertPathValidatorException.html