Класс 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

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

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:: 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:: Collection CRL, соответствующих заданному селектору (никогда null)
Throws:: CertStoreException - если произошла ошибка

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/security/cert/CertStoreSpi.html