Класс CertPathValidatorException

java.security.cert.CertPathValidatorException

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

public class CertPathValidatorException extends GeneralSecurityException

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

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

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

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

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

С тех пор, как:

1.4

См. также:

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

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

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

getCertPath

public CertPath getCertPath()

Возвращает сертификационный путь, который проверялся при возникновении исключения.

Возвращает:: CertPath, который проверялся при возникновении исключения (или null, если не указан)

getIndex

public int getIndex()

Возвращает индекс сертификата в сертификационном пути, который вызвал исключение. Обратите внимание, что список сертификатов в CertPath нулевой. Если индекс не задан, возвращается -1.

Возвращает:: заданный индекс или -1, если он не задан

getReason

public CertPathValidatorException.Reason getReason()

Возвращает причину, по которой произошла ошибка валидации. Причина связана с индексом сертификата, возвращенным методом getIndex().

Возвращает:: причину, по которой произошла ошибка валидации, или BasicReason.UNSPECIFIED, если причина не указана
C момента:: 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/security/cert/CertPathValidatorException.html