compact1, compact2, compact3

java.security.cert

Класс CertPathBuilder

java.lang. Объект

java.security.cert. CertPathBuilder

public class CertPathBuilder
extends Object

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

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

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

getRevocationChecker() метод позволяет приложению определять дополнительные специфичные для алгоритма параметры и опции, используемые CertPathBuilder проверяя состояние аннулирования сертификатов. Вот пример, демонстрирующий, как он используется с алгоритмом PKIX:

 CertPathBuilder cpb = CertPathBuilder.getInstance("PKIX");
 PKIXRevocationChecker rc = (PKIXRevocationChecker)cpb.getRevocationChecker();
 rc.setOptions(EnumSet.of(Option.PREFER_CRLS));
 params.addCertPathChecker(rc);
 CertPathBuilderResult cpbr = cpb.build(params);
 

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

• PKIX

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

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

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

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

С тех пор:

1.4

См. Также:

CertPath

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

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

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

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

Модификатор и Тип	Метод и Описание
CertPathBuilderResult	build(CertPathParameters params) Попытки создать путь сертификации, используя указанный набор параметра алгоритма.
Строка	getAlgorithm() Возвращает имя алгоритма этого CertPathBuilder.
static String	getDefaultType() Возвращает значение по умолчанию CertPathBuilder тип как определено certpathbuilder.type свойство безопасности, или строка "PKIX", если никакое такое свойство не существует.
static CertPathBuilder	getInstance(String algorithm) Возвраты a CertPathBuilder возразите, что реализует указанный алгоритм.
static CertPathBuilder	getInstance(String algorithm, Provider provider) Возвраты a CertPathBuilder возразите, что реализует указанный алгоритм.
static CertPathBuilder	getInstance(String algorithm, String provider) Возвраты a CertPathBuilder возразите, что реализует указанный алгоритм.
Провайдер	getProvider() Возвращает провайдера этого CertPathBuilder.
CertPathChecker	getRevocationChecker() Возвраты a CertPathChecker то, что инкапсулировавший CertPathBuilderSpi использование реализации, чтобы проверить состояние аннулирования сертификатов.

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

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

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

CertPathBuilder

protected CertPathBuilder(CertPathBuilderSpi builderSpi,
                          Provider provider,
                          String algorithm)

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

Параметры:

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

provider - провайдер

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

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

getInstance

public static CertPathBuilder getInstance(String algorithm)
                                   throws NoSuchAlgorithmException

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

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

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

Параметры:

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

Возвраты:

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

Броски:

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

См. Также:

Provider

getInstance

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

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

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

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

Параметры:

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

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

Возвраты:

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

Броски:

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

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

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

См. Также:

Provider

getInstance

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

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

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

Параметры:

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

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

Возвраты:

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

Броски:

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

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

См. Также:

Provider

getProvider

public final Provider getProvider()

Возвращает провайдера этого CertPathBuilder.

Возвраты:

провайдер этого CertPathBuilder

getAlgorithm

public final String getAlgorithm()

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

Возвраты:

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

создать

public final CertPathBuilderResult build(CertPathParameters params)
                                  throws CertPathBuilderException,
                                         InvalidAlgorithmParameterException

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

Параметры:

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

Возвраты:

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

Броски:

CertPathBuilderException - если разработчик неспособен создать путь сертификации, который удовлетворяет указанные параметры

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

getDefaultType

public static final String getDefaultType()

Возвращает значение по умолчанию CertPathBuilder тип как определено certpathbuilder.type свойство безопасности, или строка "PKIX", если никакое такое свойство не существует.

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

Значение по умолчанию CertPathBuilder тип может быть изменен, устанавливая значение certpathbuilder.type свойство безопасности к требуемому типу.

Возвраты:

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

См. Также:

security properties

getRevocationChecker

public final CertPathChecker getRevocationChecker()

Возвраты a CertPathChecker то, что инкапсулировавший CertPathBuilderSpi использование реализации, чтобы проверить состояние аннулирования сертификатов. Реализация PKIX возвращает объекты типа PKIXRevocationChecker. Каждый вызов этого метода возвращает новый экземпляр CertPathChecker.

Основная цель этого метода состоит в том, чтобы позволить вызывающим сторонам определять дополнительные входные параметры и опции, определенные для проверки аннулирования. См. описание class для примера.

Возвраты:

a CertPathChecker

Броски:

UnsupportedOperationException - если поставщик услуг не поддерживает этот метод

С тех пор:

1.8