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

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

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 CertStores) могут выбросить CertStoreException, если не предоставлен непустой CertSelector, содержащий определённые критерии для поиска сертификатов. Имя издателя и/или субъекта являются особенно полезными критериями.

Parameters:: selector - CertSelector для выбора возвращаемых Certificates. Укажите 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 CertStores) могут выбросить CertStoreException, если не предоставлен непустой CRLSelector с определенными критериями для поиска CRL. Имя издателя и/или проверяемый сертификат являются особенно полезными критериями.

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

© 1993, 2023, 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/21/docs/api/java.base/java/security/cert/CertStoreSpi.html