Класс CertStoreSpi

java.lang.Object

java.security.cert.CertStoreSpi

public abstract class CertStoreSpi extends Object

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

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

Публичные методы всех объектов 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

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

Parameters:: params - параметры инициализации (могут быть null)
Throws:: 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 с конкретными критериями поиска сертификатов. Имя эмитента и/или субъекта являются особенно полезными критериями.

Parameters:: selector - CertSelector для выбора Certificateов, которые должны быть возвращены. Укажите null для возвращения всех Certificateов (если поддерживается).
Returns:: A Collection Certificateов, соответствующих заданному селектору (никогда null)
Throws:: 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. Имя эмитента и/или проверяемый сертификат являются особенно полезными критериями.

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

© 1993, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/security/cert/CertStoreSpi.html