Класс CertPathBuilder

public class CertPathBuilder
extends Object

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

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

После создания объекта 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 Cryptography Architecture по стандартным именам алгоритмов. Обратитесь к документации релиза вашей реализации, чтобы узнать, какие другие алгоритмы поддерживаются.

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

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

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

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

CertPathBuilder

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

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

Параметры:

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

provider - провайдер

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

Методы

getInstance

public static CertPathBuilder getInstance(String algorithm)
                                   throws NoSuchAlgorithmException

Параметры:

algorithm - имя запрашиваемого алгоритма CertPathBuilder. См. раздел CertPathBuilder в документации по стандартным именам алгоритмов Java Cryptography Architecture для получения информации о стандартных именах алгоритмов.

Возвращает:

объект CertPathBuilder, реализующий указанный алгоритм.

Исключения:

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

См. также:

Provider

getInstance

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

Параметры:

algorithm - имя запрашиваемого алгоритма CertPathBuilder. См. раздел CertPathBuilder в документации по стандартным именам алгоритмов Java Cryptography Architecture для получения информации о стандартных именах алгоритмов.

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

Возвращает:

объект CertPathBuilder, реализующий указанный алгоритм.

Исключения:

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

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

IllegalArgumentException - если указанный провайдер является null или пустым.

См. также:

Provider

getInstance

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

Параметры:

algorithm - имя запрашиваемого алгоритма CertPathBuilder. См. раздел CertPathBuilder в документации по стандартным именам алгоритмов Java Cryptography Architecture для получения информации о стандартных именах алгоритмов.

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

Возвращает:

объект CertPathBuilder, реализующий указанный алгоритм.

Исключения:

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

IllegalArgumentException - если указанный провайдер является null.

См. также:

Provider

getProvider

public final Provider getProvider()

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

Возвращает:

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

getAlgorithm

public final String getAlgorithm()

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

Возвращает:

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

build

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

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

Параметры:

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

Возвращает:

результат алгоритма построения

Исключения:

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

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

getDefaultType

public static final String getDefaultType()

Возвращает:

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

См. также:

security properties

getRevocationChecker

public final CertPathChecker getRevocationChecker()

Возвращает:

CertPathChecker

Исключения:

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

С:

1.8