Класс CertStore

public class CertStore
extends Object

Класс для получения Certificate и CRL из хранилища.

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

После создания CertStore, можно получить Certificate и CRL, вызвав его методы getCertificates и getCRLs.

В отличие от KeyStore, предоставляющего доступ к кэшу закрытых ключей и доверенных сертификатов, CertStore предназначен для доступа к потенциально обширному хранилищу ненадёжных сертификатов и CRL. Например, реализация CertStore с использованием LDAP предоставляет доступ к сертификатам и CRL, хранящимся в одном или нескольких каталогах с использованием протокола LDAP и схемы, определённой в атрибуте сервиса RFC.

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

• Collection

Этот тип описан в разделе Раздел CertStore документации Java Cryptography Architecture Standard Algorithm Name. Обратитесь к документации вашей реализации, чтобы узнать о поддержке других типов.

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

Все публичные методы объектов CertStore должны быть потокобезопасными. То есть, несколько потоков могут одновременно вызывать эти методы на одном объекте CertStore (или более чем на одном) без негативных последствий. Это позволяет одному потоку искать CRL, а другому – дополнительные сертификаты, например.

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

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

CertStore

protected CertStore(CertStoreSpi storeSpi,
                    Provider provider,
                    String type,
                    CertStoreParameters params)

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

Параметры:

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

provider - провайдер

type - тип

params - параметры инициализации (могут быть null)

Методы

getCertificates

public final Collection<? extends Certificate> getCertificates(CertSelector selector)
                                                        throws CertStoreException

Параметры:

selector - CertSelector для выбора возвращаемых Certificateов. Укажите null для возвращения всех Certificateов (если поддерживается).

Возвращает:

A Collection Certificateов, соответствующих заданному селектору (никогда null)

Исключение:

CertStoreException - если произошла ошибка

getCRLs

public final Collection<? extends CRL> getCRLs(CRLSelector selector)
                                        throws CertStoreException

Параметры:

selector - CRLSelector для выбора возвращаемых CRLов. Укажите null для возвращения всех CRLов (если поддерживается).

Возвращает:

A Collection CRLов, соответствующих заданному селектору (никогда null)

Исключение:

CertStoreException - если произошла ошибка

getInstance

public static CertStore getInstance(String type,
                                    CertStoreParameters params)
                             throws InvalidAlgorithmParameterException,
                                    NoSuchAlgorithmException

Параметры:

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

params - параметры инициализации (могут быть null).

Возвращает:

объект CertStore, реализующий указанный тип CertStore.

Исключение:

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

InvalidAlgorithmParameterException - если указанные параметры инициализации не подходят для данного CertStore.

См. также:

Provider

getInstance

public static CertStore getInstance(String type,
                                    CertStoreParameters params,
                                    String provider)
                             throws InvalidAlgorithmParameterException,
                                    NoSuchAlgorithmException,
                                    NoSuchProviderException

Параметры:

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

params - параметры инициализации (могут быть null).

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

Возвращает:

объект CertStore, реализующий указанный тип.

Исключение:

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

InvalidAlgorithmParameterException - если указанные параметры инициализации не подходят для данного CertStore.

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

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

См. также:

Provider

getInstance

public static CertStore getInstance(String type,
                                    CertStoreParameters params,
                                    Provider provider)
                             throws NoSuchAlgorithmException,
                                    InvalidAlgorithmParameterException

Параметры:

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

params - параметры инициализации (могут быть null).

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

Возвращает:

объект CertStore, реализующий указанный тип.

Исключение:

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

InvalidAlgorithmParameterException - если указанные параметры инициализации не подходят для данного CertStore

IllegalArgumentException - если указанный provider равен null.

См. также:

Provider

getCertStoreParameters

public final CertStoreParameters getCertStoreParameters()

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

Возвращает:

используемые параметры инициализации данного CertStore (могут быть null)

getType

public final String getType()

Возвращает тип данного CertStore.

Возвращает:

тип данного CertStore

getProvider

public final Provider getProvider()

Возвращает провайдера данного CertStore.

Возвращает:

провайдера данного CertStore

getDefaultType

public static final String getDefaultType()

Возвращает:

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

См. также:

security properties