Класс CertPathValidatorException

public class CertPathValidatorException
extends GeneralSecurityException

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

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

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

Доступ к данным из нескольких потоков

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

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

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).

Параметры:

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()

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

Возвращает:

сертификационный путь, который проверялся при возникновении исключения (или null если не указан)

getIndex

public int getIndex()

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

Возвращает:

заданный индекс или -1, если индекс не задан

getReason

public CertPathValidatorException.Reason getReason()

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

Возвращает:

причину, по которой проверка завершилась ошибкой, или BasicReason.UNSPECIFIED если причина не задана

С момента:

1.7