Android APIs
public class

CertStore

extends Object
java.lang.Object
   ↳ java.security.cert.CertStore

Class Overview

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.

Summary

Protected Constructors
CertStore(CertStoreSpi storeSpi, Provider provider, String type, CertStoreParameters params)
Creates a new CertStore instance.
Public Methods
final Collection<? extends CRL> getCRLs(CRLSelector selector)
Returns the list of CRLs for the specified CRLSelector from this certificate store.
final CertStoreParameters getCertStoreParameters()
Returns a copy of the certificate store parameters that were used to initialize this instance.
final Collection<? extends Certificate> getCertificates(CertSelector selector)
Returns the list of Certificates for the specified CertSelector from this certificate store.
final static String getDefaultType()
Returns the default CertStore type from the Security Properties.
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)
Creates a new CertStore instance 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.
final Provider getProvider()
Returns the security provider.
final String getType()
Returns the certificate store type.
[Expand]
Inherited Methods
From class java.lang.Object

Protected Constructors

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

Added in API level 1

Creates a new CertStore instance.

Parameters
storeSpi CertStoreSpi: the implementation delegate.
provider Provider: the security provider.
type String: the certificate store type.
params CertStoreParameters: the certificate store parameters (may be null.

Public Methods

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

Added in API level 1

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

Parameters
selector CRLSelector: the selector containing the criteria to search for certificate revocation lists in this store.
Returns
Collection<? extends CRL> the list of CRLs that match the criteria of the specified selector
Throws
CertStoreException if error(s) occur.

public final CertStoreParameters getCertStoreParameters ()

Added in API level 1

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

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

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

Added in API level 1

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

Parameters
selector CertSelector: the selector containing the criteria to search for certificates in this certificate store.
Returns
Collection<? extends Certificate> the list of Certificates that match the criteria of the specified selector.
Throws
CertStoreException if error(s) occur.

public static final String getDefaultType ()

Added in API level 1

Returns the default CertStore type from the Security Properties.

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

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

Added in API level 1

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 String: the certificate store type.
params CertStoreParameters: the certificate store parameters (may be null).
provider Provider: the name of the provider.
Returns
CertStore 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

public static CertStore getInstance (String type, CertStoreParameters params)

Added in API level 1

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

Parameters
type String: the certificate store type.
params CertStoreParameters: the certificate store parameters (may be null).
Returns
CertStore 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

public static CertStore getInstance (String type, CertStoreParameters params, String provider)

Added in API level 1

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

Parameters
type String: the certificate store type.
params CertStoreParameters: the certificate store parameters (may be null).
provider String: the name of the provider.
Returns
CertStore 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.

public final Provider getProvider ()

Added in API level 1

Returns the security provider.

Returns
Provider the security provider.

public final String getType ()

Added in API level 1

Returns the certificate store type.

Returns
String the certificate store type.