CertPathBuilder (Платформа Java SE 7)

java.lang. Объект
- java.security.cert. CertPathBuilder

```
public class CertPathBuilder
extends Object
```
Класс для создания путей сертификации (также известный как цепочки сертификата).
Этот класс использует основанную на провайдере архитектуру. Создать a CertPathBuilder, вызовите одни из помех getInstance методы, передающие на имя алгоритма CertPathBuilder требуемый и дополнительно имя провайдера требуется.
Однажды a CertPathBuilder объект был создан, пути сертификации могут быть созданы, вызывая build метод и передача этого специфичный для алгоритма набор параметров. В случае успеха, результат (включая CertPath это было создано), возвращается в объекте, который реализует CertPathBuilderResult интерфейс.
Каждая реализация платформы Java обязана поддерживать следующий стандарт CertPathBuilder алгоритм:
- PKIX
Этот алгоритм описывается в разделе CertPathBuilder Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java. Консультируйтесь с документацией выпуска для своей реализации, чтобы видеть, поддерживаются ли какие-либо другие алгоритмы.
Параллельный Доступ
Статические методы этого класса, как гарантируют, будут ориентированы на многопотоковое исполнение. Многократные потоки могут одновременно вызвать статические методы, определенные в этом классе без вредных воздействий.
Однако, это не истина для нестатических методов, определенных этим классом. Если иначе не задокументировано определенным провайдером, потоки, которые должны получить доступ к синглу 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` тип как определено в файле свойств безопасности Java, или строке "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`.

Методы 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 тип как определено в файле свойств безопасности Java, или строке "PKIX", если никакое такое свойство не существует. Файл свойств безопасности Java располагается в файле под названием <JAVA_HOME>/lib/security/java.security. <JAVA_HOME> обращается к значению java.home системного свойства, и определяет каталог, где JRE устанавливается.
    Значение по умолчанию CertPathBuilder тип может использоваться приложениями, которые не хотят использовать трудно кодированный тип, вызывая один из getInstance методы, и хотят обеспечить тип по умолчанию в случае, если пользователь не определяет его собственное.
    Значение по умолчанию CertPathBuilder тип может быть изменен, устанавливая значение "certpathbuilder.type" свойства безопасности (в файле свойств безопасности Java) к требуемому типу.
    
    Возвраты:
    значение по умолчанию CertPathBuilder тип как определено в файле свойств безопасности Java, или строке "PKIX", если никакое такое свойство не существует.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс CertPathBuilder

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

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

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

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

CertPathBuilder

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

getInstance

getInstance

getInstance

getProvider

getAlgorithm

сборка

getDefaultType