Класс 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 (или более чем на одном) без каких-либо негативных последствий. Это позволяет, например, одному потоку искать 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 - если произошла ошибка

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.