eu.europa.esig.dss.x509

Interface CertificateSource

All Superinterfaces:

Serializable

All Known Implementing Classes:

CommonCertificateSource, CommonTrustedCertificateSource, KeyStoreCertificateSource, SignatureCertificateSource, TrustedListsCertificateSource

public interface CertificateSource
extends Serializable

The validation of a certificate requires to access some other certificates from multiple sources (Trusted List, Trust Store, the signature itself). This interface provides an abstraction for accessing a certificate, regardless of the source.

Method Summary

Modifier and Type	Method and Description
CertificateToken	addCertificate(CertificateToken certificate) This method allows to manually add any certificate to the source.
List<CertificateToken>	get(X500Principal x500Principal) This method returns the List of CertificateToken(s) corresponding to the given subject distinguished name.
CertificatePool	getCertificatePool() This method return the CertificatePool encapsulated by the source.
List<CertificateToken>	getCertificates() Retrieves the unmodifiable list of all certificate tokens from this source.
CertificateSourceType	getCertificateSourceType() This method returns the certificate source type associated to the implementation class.

Method Detail

getCertificatePool

CertificatePool getCertificatePool()

This method return the CertificatePool encapsulated by the source.

Returns:

the certificate pool

addCertificate

CertificateToken addCertificate(CertificateToken certificate)

This method allows to manually add any certificate to the source. The type of the source is automatically set par each specific implementation.

Parameters:

certificate - the certificate you have to trust

Returns:

the corresponding certificate token

get

List<CertificateToken> get(X500Principal x500Principal)

This method returns the List of CertificateToken(s) corresponding to the given subject distinguished name. The search is performed at the level of source and not at the pool level (The same pool can be shared by many sources).

Parameters:

x500Principal - subject distinguished names of the certificate to find

Returns:

a List of CertificateToken which have x500Principal as subject

getCertificateSourceType

CertificateSourceType getCertificateSourceType()

This method returns the certificate source type associated to the implementation class.

Returns:

the certificate origin

getCertificates

List<CertificateToken> getCertificates()

Retrieves the unmodifiable list of all certificate tokens from this source.

Returns:

all certificates from this source