Класс CertStoreSpi

java.lang.Object
- java.security.cert.CertStoreSpi

public abstract class CertStoreSpi
extends Object

Интерфейс поставщика сервисов (SPI) для класса CertStore. Все CertStore реализации должны включать класс (класс SPI), который расширяет этот класс (CertStoreSpi), предоставляет конструктор с одним аргументом типа CertStoreParameters, и реализует все его методы. В общем случае к экземплярам этого класса следует обращаться только через класс CertStore. Подробнее см. в Java Cryptography Architecture.

Доступность при одновременном доступе

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

Простые CertStoreSpi реализации, вероятно, обеспечат потоковую безопасность, добавив ключевое слово synchronized к их методам engineGetCertificates и engineGetCRLs. Более сложные реализации могут позволить по-настоящему одновременный доступ.

Since:: 1.4

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

Конструктор	Описание
`CertStoreSpi(CertStoreParameters params)`	Единственный конструктор.

Методы

Модификатор и тип	Метод	Описание
`abstract Collection<? extends Certificate>`	`engineGetCertificates(CertSelector selector)`	Возвращает `Collection` `Certificate` , соответствующих указанному селектору.
`abstract Collection<? extends CRL>`	`engineGetCRLs(CRLSelector selector)`	Возвращает `Collection` `CRL` , соответствующих указанному селектору.

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

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

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

CertStoreSpi

public CertStoreSpi(CertStoreParameters params)
             throws InvalidAlgorithmParameterException

Единственный конструктор.

Параметры:: params - параметры инициализации (могут быть null)
Исключения:: InvalidAlgorithmParameterException - если параметры инициализации не подходят для этого CertStoreSpi

Методы

engineGetCertificates

public abstract Collection<? extends Certificate> engineGetCertificates(CertSelector selector)
                                                                 throws CertStoreException

Возвращает Collection Certificate , соответствующих указанному селектору. Если Certificate не соответствуют селектору, будет возвращён пустой Collection.

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

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

Параметры:: selector - CertSelector , используемый для выбора Certificate , которые должны быть возвращены. Укажите null для возвращения всех Certificate (если поддерживается).
Возвращает:: Collection Certificate , соответствующих указанному селектору (никогда null)
Исключения:: CertStoreException - если произошла ошибка

engineGetCRLs

public abstract Collection<? extends CRL> engineGetCRLs(CRLSelector selector)
                                                 throws CertStoreException

Возвращает Collection CRL , соответствующих указанному селектору. Если CRL не соответствуют селектору, будет возвращён пустой Collection.

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

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

Параметры:: selector - CRLSelector , используемый для выбора CRL , которые должны быть возвращены. Укажите null для возвращения всех CRL (если поддерживается).
Возвращает:: Collection CRL , соответствующих указанному селектору (никогда null)
Исключения:: CertStoreException - если произошла ошибка