Класс 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

Модификатор и тип	Метод	Описание
`final void`	`addSuppressed(Throwable exception)`	Добавляет указанное исключение к исключениям, которые были подавлены при возникновении этого исключения.
`Throwable`	`fillInStackTrace()`	Заполняет трассировку стека вызовов.
`Throwable`	`getCause()`	Возвращает причину возникновения этого объекта throwable или `null`, если причина отсутствует или неизвестна.
`String`	`getLocalizedMessage()`	Создаёт локализованное описание этого объекта throwable.
`String`	`getMessage()`	Возвращает строку с подробным сообщением этого объекта throwable.
`StackTraceElement[]`	`getStackTrace()`	Предоставляет программный доступ к информации о трассировке стека, выводимой методом `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Возвращает массив, содержащий все исключения, которые были подавлены, обычно оператором `try`-with-resources, при возникновении этого исключения.
`Throwable`	`initCause(Throwable cause)`	Инициализирует причину возникновения этого объекта throwable указанным значением.
`void`	`printStackTrace()`	Выводит этот объект throwable и его трассировку в стандартный поток ошибок.
`void`	`printStackTrace(PrintStream s)`	Выводит этот объект throwable и его трассировку в указанный поток печати.
`void`	`printStackTrace(PrintWriter s)`	Выводит этот объект throwable и его трассировку в указанный объект записи.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Задаёт элементы трассировки стека, которые будут возвращены методом `Throwable.getStackTrace()` и выведены методами `Throwable.printStackTrace()` и связанными с ним.
`String`	`toString()`	Возвращает краткое описание этого объекта throwable.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс среды выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

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.