iaik.smime.ess.utils
Interface CertificateDatabase

All Known Subinterfaces:

KeyDatabase

All Known Implementing Classes:

EncryptedKeyStoreDatabase, KeyStoreDatabase

public interface CertificateDatabase

A simple certificate database allowing to query for certificates based on certificate identifiers.

Method Summary

X509Certificate	getCertificate(CertificateIdentifier certID) Gets the certificate belonging to the given certificate identidier.
X509Certificate[]	getCertificateChain(CertificateIdentifier certID) Gets the certificate chain belonging to the given certificate identidier.

Method Detail

getCertificateChain

X509Certificate[] getCertificateChain(CertificateIdentifier certID)
                                      throws CertificateDatabaseException

Gets the certificate chain belonging to the given certificate identidier.

Parameters:

certID - the certificate identifier identifying the entity to which the requested certificate key belongs to

Returns:

the certificate chain belonging to the entity identified by the given certificate identifier (the entity certificate has to be located at index 0 of the returned array); the array may be empty if no certificates for the given identifier are found

Throws:

CertificateDatabaseException - if there occurs some problem when trying to fetch the certificate chain

getCertificate

X509Certificate getCertificate(CertificateIdentifier certID)
                               throws CertificateDatabaseException

Gets the certificate belonging to the given certificate identidier.

Parameters:

certID - the certificate identifier identifying the entity to which the requested certificate key belongs to

Returns:

the certificate belonging to the entity identified by the given certificate identifier; or null if no certificate for the given identifier are found

Throws:

CertificateDatabaseException - if there occurs some problem when trying to fetch the certificate