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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарел и предназначен для удаления: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет заданный промежуток реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет заданный промежуток реального времени.

Подробное описание конструкторов

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.