Класс 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, 2021, 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/17/docs/api/java.base/java/security/cert/CertPathValidatorException.html