compact1, compact2, compact3

java.security.cert

Класс CertStore

java.lang. Объект

java.security.cert. CertStore

public class CertStore
extends Object

class для того, чтобы получить Certificates и CRLs от репозитария.

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

Однажды CertStore был создан, это может использоваться, чтобы получить Certificates и CRLs, вызывая getCertificates и getCRLs методы.

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

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

• Collection

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

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

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

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

С тех пор:

1.4

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

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

Модификатор	Конструктор и Описание
protected	CertStore(CertStoreSpi storeSpi, Provider provider, String type, CertStoreParameters params) Создает a CertStore объект данного типа, и инкапсулирует данную реализацию провайдера (объект SPI) в этом.

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

Модификатор и Тип	Метод и Описание
Collection<? extends Certificate>	getCertificates(CertSelector selector) Возвраты a Collection из Certificates, которые соответствуют указанный селектор.
CertStoreParameters	getCertStoreParameters() Возвращает параметры, используемые, чтобы инициализировать это CertStore.
Collection<? extends CRL>	getCRLs(CRLSelector selector) Возвраты a Collection из CRLs, которые соответствуют указанный селектор.
static String	getDefaultType() Возвращает значение по умолчанию CertStore тип как определено certstore.type свойство безопасности, или строка "LDAP", если никакое такое свойство не существует.
static CertStore	getInstance(String type, CertStoreParameters params) Возвраты a CertStore возразите, что реализует указанное CertStore введите и инициализируется с указанными параметрами.
static CertStore	getInstance(String type, CertStoreParameters params, Provider provider) Возвраты a CertStore возразите, что реализует указанное CertStore ввести.
static CertStore	getInstance(String type, CertStoreParameters params, String provider) Возвраты a CertStore возразите, что реализует указанное CertStore ввести.
Провайдер	getProvider() Возвращает провайдера этого CertStore.
Строка	getType() Возвращает тип этого CertStore.

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

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

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

CertStore

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

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

Параметры:

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

provider - провайдер

type - тип

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

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

getCertificates

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

Возвраты a Collection из Certificates, которые соответствуют указанный селектор. Если нет Certificates соответствуют селектор, пустое Collection будет возвращен.

Для некоторых CertStore типы, получающееся Collection возможно, не содержит весь из Certificates, которые соответствуют селектор. Например, LDAP CertStore возможно, не ищет все записи в каталоге. Вместо этого это может только искать записи, которые, вероятно, будут содержать Certificates это ищет.

Некоторые CertStore реализации (особенно LDAP CertStores) может бросить a CertStoreException если ненуль CertSelector то, при условии, что включает определенные критерии, которые могут использоваться, чтобы найти сертификаты. Выпускающий и/или подчиненные имена являются особенно полезными критериями.

Параметры:

selector - A CertSelector используемый, чтобы выбрать, который Certificates должен быть возвращен. Определить null возвратить все Certificates (если поддерживающийся).

Возвраты:

A Collection из Certificates, которые соответствуют указанный селектор (никогда null)

Броски:

CertStoreException - если исключение происходит

getCRLs

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

Возвраты a Collection из CRLs, которые соответствуют указанный селектор. Если нет CRLs соответствуют селектор, пустое Collection будет возвращен.

Для некоторых CertStore типы, получающееся Collection возможно, не содержит весь из CRLs, которые соответствуют селектор. Например, LDAP CertStore возможно, не ищет все записи в каталоге. Вместо этого это может только искать записи, которые, вероятно, будут содержать CRLs это ищет.

Некоторые CertStore реализации (особенно LDAP CertStores) может бросить a CertStoreException если ненуль CRLSelector то, при условии, что включает определенные критерии, которые могут использоваться, чтобы найти CRL. Имена выпускающего и/или сертификат, который будет проверен, особенно полезны.

Параметры:

selector - A CRLSelector используемый, чтобы выбрать, который CRLs должен быть возвращен. Определить null возвратить все CRLs (если поддерживающийся).

Возвраты:

A Collection из CRLs, которые соответствуют указанный селектор (никогда null)

Броски:

CertStoreException - если исключение происходит

getInstance

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

Возвраты a CertStore возразите, что реализует указанное CertStore введите и инициализируется с указанными параметрами.

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

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

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

Параметры:

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

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

Возвраты:

a CertStore возразите, что реализует указанное CertStore ввести.

Броски:

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

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

См. Также:

Provider

getInstance

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

Возвраты a CertStore возразите, что реализует указанное CertStore ввести.

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

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

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

Параметры:

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

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

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

Возвраты:

a CertStore возразите, что реализует указанный тип.

Броски:

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

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

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

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

См. Также:

Provider

getInstance

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

Возвраты a CertStore возразите, что реализует указанное CertStore ввести.

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

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

Параметры:

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

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

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

Возвраты:

a CertStore возразите, что реализует указанный тип.

Броски:

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

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

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

См. Также:

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", если никакое такое свойство не существует.

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

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

Возвраты:

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

См. Также:

security properties