Класс CertPathValidatorException

java.security.cert.CertPathValidatorException

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

public class CertPathValidatorException extends GeneralSecurityException

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

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

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`, оборачивающее указанный throwable.

Краткое описание методов

Модификатор и тип	Метод	Описание
`CertPath`	`getCertPath()`	Возвращает сертификационный путь, проверявшийся в момент возникновения исключения.
`int`	`getIndex()`	Возвращает индекс сертификата в сертификационном пути, вызвавшего исключение.
`CertPathValidatorException.Reason`	`getReason()`	Возвращает причину сбоя проверки.

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

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

Методы, объявленные в классе 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, оборачивающее указанный throwable. Это позволяет преобразовать любое исключение в 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, 2025, 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/25/docs/api/java.base/java/security/cert/CertPathValidatorException.html