java.security.cert

Class CertStore

java.lang.Object

java.security.cert.CertStore

public class CertStore
extends Object

This class provides the functionality to retrieve Certificates and CRLs from a read-only repository. This repository may be very large and may store trusted as well as untrusted certificates.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CertStore(CertStoreSpi storeSpi, Provider provider, String type, CertStoreParameters params) Creates a new CertStore instance.

Method Summary

Modifier and Type	Method and Description
Collection<? extends Certificate>	getCertificates(CertSelector selector) Returns the list of Certificates for the specified CertSelector from this certificate store.
CertStoreParameters	getCertStoreParameters() Returns a copy of the certificate store parameters that were used to initialize this instance.
Collection<? extends CRL>	getCRLs(CRLSelector selector) Returns the list of CRLs for the specified CRLSelector from this certificate store.
static String	getDefaultType() Returns the default CertStore type from the Security Properties.
static CertStore	getInstance(String type, CertStoreParameters params) Creates a new CertStore instance with the specified type and initialized with the specified parameters.
static CertStore	getInstance(String type, CertStoreParameters params, Provider provider) Creates a new CertStore instance from the specified provider with the specified type and initialized with the specified parameters.
static CertStore	getInstance(String type, CertStoreParameters params, String provider) Creates a new CertStore instance from the specified provider with the specified type and initialized with the specified parameters.
Provider	getProvider() Returns the security provider.
String	getType() Returns the certificate store type.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CertStore

protected CertStore(CertStoreSpi storeSpi,
                    Provider provider,
                    String type,
                    CertStoreParameters params)

Creates a new CertStore instance.

Parameters:

storeSpi - the implementation delegate.

provider - the security provider.

type - the certificate store type.

params - the certificate store parameters (may be null.

Method Detail

getInstance

public static CertStore getInstance(String type,
                                    CertStoreParameters params)
                             throws InvalidAlgorithmParameterException,
                                    NoSuchAlgorithmException

Creates a new CertStore instance with the specified type and initialized with the specified parameters.

Parameters:

type - the certificate store type.

params - the certificate store parameters (may be null).

Returns:

the new certificate store instance.

Throws:

NoSuchAlgorithmException - if no provider can provide the specified certificate store type.

InvalidAlgorithmParameterException - if the specified parameters cannot be used to initialize this certificate store instance.

NullPointerException - if type == null

getInstance

public static CertStore getInstance(String type,
                                    CertStoreParameters params,
                                    String provider)
                             throws InvalidAlgorithmParameterException,
                                    NoSuchAlgorithmException,
                                    NoSuchProviderException

Creates a new CertStore instance from the specified provider with the specified type and initialized with the specified parameters.

Parameters:

type - the certificate store type.

params - the certificate store parameters (may be null).

provider - the name of the provider.

Returns:

the new certificate store instance.

Throws:

NoSuchAlgorithmException - if the specified provider cannot provide the requested certificate store type.

NoSuchProviderException - if no provider with the specified name can be found.

InvalidAlgorithmParameterException - if the specified parameters cannot be used to initialize this certificate store instance.

IllegalArgumentException - if provider == null || provider.isEmpty()

NullPointerException - if type is null.

getInstance

public static CertStore getInstance(String type,
                                    CertStoreParameters params,
                                    Provider provider)
                             throws NoSuchAlgorithmException,
                                    InvalidAlgorithmParameterException

Creates a new CertStore instance from the specified provider with the specified type and initialized with the specified parameters. The provider supplied does not have to be registered.

Parameters:

type - the certificate store type.

params - the certificate store parameters (may be null).

provider - the name of the provider.

Returns:

the new certificate store instance.

Throws:

NoSuchAlgorithmException - if the specified provider cannot provide the requested certificate store type.

InvalidAlgorithmParameterException - if the specified parameters cannot be used to initialize this certificate store instance.

IllegalArgumentException - if provider == null

NullPointerException - if type == null

getType

public final String getType()

Returns the certificate store type.

Returns:

the certificate store type.

getProvider

public final Provider getProvider()

Returns the security provider.

Returns:

the security provider.

getCertStoreParameters

public final CertStoreParameters getCertStoreParameters()

Returns a copy of the certificate store parameters that were used to initialize this instance.

Returns:

a copy of the certificate store parameters or null if none were specified.

getCertificates

public final Collection<? extends Certificate> getCertificates(CertSelector selector)
                                                        throws CertStoreException

Returns the list of Certificates for the specified CertSelector from this certificate store.

Parameters:

selector - the selector containing the criteria to search for certificates in this certificate store.

Returns:

the list of Certificates that match the criteria of the specified selector.

Throws:

CertStoreException - if error(s) occur.

getCRLs

public final Collection<? extends CRL> getCRLs(CRLSelector selector)
                                        throws CertStoreException

Returns the list of CRLs for the specified CRLSelector from this certificate store.

Parameters:

selector - the selector containing the criteria to search for certificate revocation lists in this store.

Returns:

the list of CRLs that match the criteria of the specified selector

Throws:

CertStoreException - if error(s) occur.

getDefaultType

public static final String getDefaultType()

Returns the default CertStore type from the Security Properties.

Returns:

the default CertStore type from the Security Properties, or the string "LDAP" if it cannot be determined.