# CertStoreSpi

public abstract class **CertStoreSpi** extends [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)  
The *Service Provider Interface* (**SPI** )
for the `https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CertStore.html` class. All `CertStore`
implementations must include a class (the SPI class) that extends
this class (`CertStoreSpi`), provides a constructor with
a single argument of type `CertStoreParameters`, and implements
all of its methods. In general, instances of this class should only be
accessed through the `CertStore` class.
For details, see the Java Cryptography Architecture.


**Concurrent Access**


The public methods of all `CertStoreSpi` objects must be
thread-safe. That is, multiple threads may concurrently invoke these
methods on a single `CertStoreSpi` object (or more than one)
with no ill effects. This allows a `CertPathBuilder` to search
for a CRL while simultaneously searching for further certificates, for
instance.


Simple `CertStoreSpi` implementations will probably ensure
thread safety by adding a `synchronized` keyword to their
`engineGetCertificates` and `engineGetCRLs` methods.
More sophisticated ones may allow truly concurrent access.

### Public Constructor Summary

|---|---|
|   | [CertStoreSpi](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CertStoreSpi.html#CertStoreSpi(java.security.cert.CertStoreParameters))([CertStoreParameters](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CertStoreParameters.html) params) The sole constructor. |

### Public Method Summary

|---|---|
| abstract [Collection](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/Collection.html)\<? extends [CRL](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CRL.html)\> | [engineGetCRLs](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CertStoreSpi.html#engineGetCRLs(java.security.cert.CRLSelector))([CRLSelector](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CRLSelector.html) selector) Returns a `Collection` of `CRL`s that match the specified selector. |
| abstract [Collection](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/Collection.html)\<? extends [Certificate](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/Certificate.html)\> | [engineGetCertificates](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CertStoreSpi.html#engineGetCertificates(java.security.cert.CertSelector))([CertSelector](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CertSelector.html) selector) Returns a `Collection` of `Certificate`s that match the specified selector. |

### Inherited Method Summary

From class [java.lang.Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html)

|---|---|
| [Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) | [clone](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#clone())() Creates and returns a copy of this `Object`. |
| boolean | [equals](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#equals(java.lang.Object))([Object](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html) obj) Compares this instance with the specified object and indicates if they are equal. |
| void | [finalize](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#finalize())() Invoked when the garbage collector has detected that this instance is no longer reachable. |
| final [Class](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html)\<?\> | [getClass](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#getClass())() Returns the unique instance of `https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Class.html` that represents this object's class. |
| int | [hashCode](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#hashCode())() Returns an integer hash code for this object. |
| final void | [notify](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#notify())() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up. |
| final void | [notifyAll](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#notifyAll())() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up. |
| [String](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/String.html) | [toString](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#toString())() Returns a string containing a concise, human-readable description of this object. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long,%20int))(long timeout, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait(long))(long timeout) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires. |
| final void | [wait](https://developers.google.com/j2objc/javadoc/jre/reference/java/lang/Object.html#wait())() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object. |

## Public Constructors

#### public
**CertStoreSpi**
([CertStoreParameters](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CertStoreParameters.html) params)

The sole constructor.

##### Parameters

| params | the initialization parameters (may be `null`) |
|---|---|

##### Throws

| [InvalidAlgorithmParameterException](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/InvalidAlgorithmParameterException.html) | if the initialization parameters are inappropriate for this `CertStoreSpi` |
|---|---|

## Public Methods

#### public abstract [Collection](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/Collection.html)\<? extends [CRL](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CRL.html)\>
**engineGetCRLs**
([CRLSelector](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CRLSelector.html) selector)

Returns a `Collection` of `CRL`s that
match the specified selector. If no `CRL`s
match the selector, an empty `Collection` will be returned.


For some `CertStore` types, the resulting
`Collection` may not contain **all** of the
`CRL`s that match the selector. For instance,
an LDAP `CertStore` may not search all entries in the
directory. Instead, it may just search entries that are likely to
contain the `CRL`s it is looking for.


Some `CertStore` implementations (especially LDAP
`CertStore`s) may throw a `CertStoreException`
unless a non-null `CRLSelector` is provided that includes
specific criteria that can be used to find the CRLs. Issuer names
and/or the certificate to be checked are especially useful.

##### Parameters

| selector | A `CRLSelector` used to select which `CRL`s should be returned. Specify `null` to return all `CRL`s (if supported). |
|---|---|

##### Returns

- A `Collection` of `CRL`s that match the specified selector (never `null`)

##### Throws

| [CertStoreException](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CertStoreException.html) | if an exception occurs |
|---|---|

#### public abstract [Collection](https://developers.google.com/j2objc/javadoc/jre/reference/java/util/Collection.html)\<? extends [Certificate](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/Certificate.html)\>
**engineGetCertificates**
([CertSelector](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CertSelector.html) selector)

Returns a `Collection` of `Certificate`s that
match the specified selector. If no `Certificate`s
match the selector, an empty `Collection` will be returned.


For some `CertStore` types, the resulting
`Collection` may not contain **all** of the
`Certificate`s that match the selector. For instance,
an LDAP `CertStore` may not search all entries in the
directory. Instead, it may just search entries that are likely to
contain the `Certificate`s it is looking for.


Some `CertStore` implementations (especially LDAP
`CertStore`s) may throw a `CertStoreException`
unless a non-null `CertSelector` is provided that includes
specific criteria that can be used to find the certificates. Issuer
and/or subject names are especially useful criteria.

##### Parameters

| selector | A `CertSelector` used to select which `Certificate`s should be returned. Specify `null` to return all `Certificate`s (if supported). |
|---|---|

##### Returns

- A `Collection` of `Certificate`s that match the specified selector (never `null`)

##### Throws

| [CertStoreException](https://developers.google.com/j2objc/javadoc/jre/reference/java/security/cert/CertStoreException.html) | if an exception occurs |
|---|---|