Класс CertStoreSpi

java.lang.Object

java.security.cert.CertStoreSpi

public abstract class CertStoreSpi extends Object

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

Параллельный доступ

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

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

Начиная с:: 1.4

Краткое описание конструкторов

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

Краткое описание методов

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

Методы, объявленные в классе 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, 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/security/cert/CertStoreSpi.html