|
JavaTM 2 Platform Std. Ed. v1.4.2 |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Objectjava.security.cert.CertStoreSpi
The Service Provider Interface (SPI)
for the CertStore 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.
| Constructor Summary | |
CertStoreSpi(CertStoreParameters params)
The sole constructor. |
|
| Method Summary | |
abstract Collection |
engineGetCertificates(CertSelector selector)
Returns a Collection of Certificates that
match the specified selector. |
abstract Collection |
engineGetCRLs(CRLSelector selector)
Returns a Collection of CRLs that
match the specified selector. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
public CertStoreSpi(CertStoreParameters params)
throws InvalidAlgorithmParameterException
params - the initialization parameters (may be null)
InvalidAlgorithmParameterException - if the initialization
parameters are inappropriate for this CertStoreSpi| Method Detail |
public abstract Collection engineGetCertificates(CertSelector selector)
throws CertStoreException
Collection of Certificates that
match the specified selector. If no Certificates
match the selector, an empty Collection will be returned.
For some CertStore types, the resulting
Collection may not contain all of the
Certificates 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 Certificates it is looking for.
Some CertStore implementations (especially LDAP
CertStores) 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.
selector - A CertSelector used to select which
Certificates should be returned. Specify null
to return all Certificates (if supported).
Collection of Certificates that
match the specified selector (never null)
CertStoreException - if an exception occurs
public abstract Collection engineGetCRLs(CRLSelector selector)
throws CertStoreException
Collection of CRLs that
match the specified selector. If no CRLs
match the selector, an empty Collection will be returned.
For some CertStore types, the resulting
Collection may not contain all of the
CRLs 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 CRLs it is looking for.
Some CertStore implementations (especially LDAP
CertStores) 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.
selector - A CRLSelector used to select which
CRLs should be returned. Specify null
to return all CRLs (if supported).
Collection of CRLs that
match the specified selector (never null)
CertStoreException - if an exception occurs
|
JavaTM 2 Platform Std. Ed. v1.4.2 |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.