java.security.cert

Класс CertPathValidator

java.lang. Объект

java.security.cert. CertPathValidator

public class CertPathValidator
extends Object

Класс для того, чтобы проверить путей сертификации (также известный как цепочки сертификата).

Этот класс использует основанную на провайдере архитектуру. Создать a CertPathValidator, вызовите одни из помех getInstance методы, передающие на имя алгоритма CertPathValidator требуемый и дополнительно имя провайдера требуется.

Однажды a CertPathValidator объект был создан, он может использоваться, чтобы проверить путей сертификации, вызывая validate метод и передача этого CertPath быть проверенным и специфичный для алгоритма набор параметров. В случае успеха результат возвращается в объекте, который реализует CertPathValidatorResult интерфейс.

Каждая реализация платформы Java обязана поддерживать следующий стандарт CertPathValidator алгоритм:

• PKIX

Этот алгоритм описывается в разделе CertPathValidator Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java. Консультируйтесь с документацией выпуска для своей реализации, чтобы видеть, поддерживаются ли какие-либо другие алгоритмы.

Параллельный Доступ

Статические методы этого класса, как гарантируют, будут ориентированы на многопотоковое исполнение. Многократные потоки могут одновременно вызвать статические методы, определенные в этом классе без вредных воздействий.

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

С тех пор:

1.4

См. Также:

CertPath

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	CertPathValidator(CertPathValidatorSpi validatorSpi, Provider provider, String algorithm) Создает a CertPathValidator объект данного алгоритма, и инкапсулирует данную реализацию провайдера (объект SPI) в этом.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Строка	getAlgorithm() Возвращает имя алгоритма этого CertPathValidator.
static String	getDefaultType() Возвращает значение по умолчанию CertPathValidator тип как определено в файле свойств безопасности Java, или строке "PKIX", если никакое такое свойство не существует.
static CertPathValidator	getInstance(String algorithm) Возвраты a CertPathValidator возразите, что реализует указанный алгоритм.
static CertPathValidator	getInstance(String algorithm, Provider provider) Возвраты a CertPathValidator возразите, что реализует указанный алгоритм.
static CertPathValidator	getInstance(String algorithm, String provider) Возвраты a CertPathValidator возразите, что реализует указанный алгоритм.
Провайдер	getProvider() Возвраты Provider из этого CertPathValidator.
CertPathValidatorResult	validate(CertPath certPath, CertPathParameters params) Проверяет указанного пути сертификации, используя указанный набор параметра алгоритма.

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

CertPathValidator

protected CertPathValidator(CertPathValidatorSpi validatorSpi,
                 Provider provider,
                 String algorithm)

Создает a CertPathValidator объект данного алгоритма, и инкапсулирует данную реализацию провайдера (объект SPI) в этом.

Параметры:

validatorSpi - реализация провайдера

provider - провайдер

algorithm - имя алгоритма

Деталь метода

getInstance

public static CertPathValidator getInstance(String algorithm)
                                     throws NoSuchAlgorithmException

Возвраты a CertPathValidator возразите, что реализует указанный алгоритм.

Этот метод пересекает список зарегистрированных поставщиков систем обеспечения безопасности, запускающихся с самого привилегированного Провайдера. Возвращается новый объект CertPathValidator инкапсуляция реализации CertPathValidatorSpi от первого Провайдера, который поддерживает указанный алгоритм.

Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.

Параметры:

algorithm - имя требуемого CertPathValidator алгоритм. См. раздел CertPathValidator в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

Возвраты:

a CertPathValidator возразите, что реализует указанный алгоритм.

Броски:

NoSuchAlgorithmException - если никакой Провайдер не поддерживает реализацию CertPathValidatorSpi для указанного алгоритма.

См. Также:

Provider

getInstance

public static CertPathValidator getInstance(String algorithm,
                            String provider)
                                     throws NoSuchAlgorithmException,
                                            NoSuchProviderException

Возвраты a CertPathValidator возразите, что реализует указанный алгоритм.

Возвращается новый объект CertPathValidator инкапсуляция реализации CertPathValidatorSpi от указанного провайдера. Указанный провайдер должен быть зарегистрирован в списке поставщика систем обеспечения безопасности.

Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.

Параметры:

algorithm - имя требуемого CertPathValidator алгоритм. См. раздел CertPathValidator в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

provider - имя провайдера.

Возвраты:

a CertPathValidator возразите, что реализует указанный алгоритм.

Броски:

NoSuchAlgorithmException - если реализация CertPathValidatorSpi для указанного алгоритма не доступна от указанного провайдера.

NoSuchProviderException - если указанный провайдер не регистрируется в списке поставщика систем обеспечения безопасности.

IllegalArgumentException - если provider нуль или пустой.

См. Также:

Provider

getInstance

public static CertPathValidator getInstance(String algorithm,
                            Provider provider)
                                     throws NoSuchAlgorithmException

Возвраты a CertPathValidator возразите, что реализует указанный алгоритм.

Возвращается новый объект CertPathValidator инкапсуляция реализации CertPathValidatorSpi от указанного объекта Провайдера. Отметьте, что указанный объект Провайдера не должен быть зарегистрирован в списке провайдера.

Параметры:

algorithm - имя требуемого CertPathValidator алгоритм. См. раздел CertPathValidator в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

provider - провайдер.

Возвраты:

a CertPathValidator возразите, что реализует указанный алгоритм.

Броски:

NoSuchAlgorithmException - если реализация CertPathValidatorSpi для указанного алгоритма не доступна от указанного объекта Провайдера.

IllegalArgumentException - если provider нуль.

См. Также:

Provider

getProvider

public final Provider getProvider()

Возвраты Provider из этого CertPathValidator.

Возвраты:

Provider из этого CertPathValidator

getAlgorithm

public final String getAlgorithm()

Возвращает имя алгоритма этого CertPathValidator.

Возвраты:

имя алгоритма этого CertPathValidator

проверить

public final CertPathValidatorResult validate(CertPath certPath,
                               CertPathParameters params)
                                       throws CertPathValidatorException,
                                              InvalidAlgorithmParameterException

Проверяет указанного пути сертификации, используя указанный набор параметра алгоритма.

CertPath определенный должен иметь тип, который поддерживается алгоритмом проверки допустимости, иначе InvalidAlgorithmParameterException будет брошен. Например, a CertPathValidator это реализует алгоритм PKIX, проверяет CertPath объекты типа X.509.

Параметры:

certPath - CertPath быть проверенным

params - параметры алгоритма

Возвраты:

результат алгоритма проверки допустимости

Броски:

CertPathValidatorException - если CertPath не проверяет

InvalidAlgorithmParameterException - если указанные параметры или тип указанного CertPath являются несоответствующими для этого CertPathValidator

getDefaultType

public static final String getDefaultType()

Возвращает значение по умолчанию CertPathValidator тип как определено в файле свойств безопасности Java, или строке "PKIX", если никакое такое свойство не существует. Файл свойств безопасности Java располагается в файле под названием <JAVA_HOME>/lib/security/java.security. <JAVA_HOME> обращается к значению java.home системного свойства, и определяет каталог, где JRE устанавливается.

Значение по умолчанию CertPathValidator тип может использоваться приложениями, которые не хотят использовать трудно кодированный тип, вызывая один из getInstance методы, и хотят обеспечить тип по умолчанию в случае, если пользователь не определяет его собственное.

Значение по умолчанию CertPathValidator тип может быть изменен, устанавливая значение "certpathvalidator.type" свойства безопасности (в файле свойств безопасности Java) к требуемому типу.

Возвраты:

значение по умолчанию CertPathValidator тип как определено в файле свойств безопасности Java, или строке "PKIX", если никакое такое свойство не существует.