eu.europa.esig.dss.x509

Class CommonCertificateSource

java.lang.Object

eu.europa.esig.dss.x509.CommonCertificateSource

All Implemented Interfaces:

CertificateSource, Serializable

Direct Known Subclasses:

CommonTrustedCertificateSource, KeyStoreCertificateSource, SignatureCertificateSource

public class CommonCertificateSource
extends Object
implements CertificateSource

This source of certificates handles any non trusted certificates. (ex: intermediate certificates used in building certification chain)

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CommonCertificateSource() The default constructor to generate a certificates source with an independent certificates pool.
CommonCertificateSource(CertificatePool certPool) The default constructor with mandatory certificates pool.

Method Summary

Modifier and Type	Method and Description
CertificateToken	addCertificate(CertificateToken token) This method adds an external certificate to the encapsulated pool and 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.
int	getNumberOfCertificates() This method returns the number of stored certificates in this source
boolean	removeCertificate(CertificateToken certificate) This method is used internally to remove a certificate from the CertificatePool.

Methods inherited from class java.lang.Object

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

Constructor Detail

CommonCertificateSource

public CommonCertificateSource()

The default constructor to generate a certificates source with an independent certificates pool.

CommonCertificateSource

public CommonCertificateSource(CertificatePool certPool)

The default constructor with mandatory certificates pool.

Parameters:

certPool - the certificate pool to use

Method Detail

getCertificateSourceType

public CertificateSourceType getCertificateSourceType()

Description copied from interface: CertificateSource

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

Specified by:

getCertificateSourceType in interface CertificateSource

Returns:

the certificate origin

getCertificatePool

public CertificatePool getCertificatePool()

Description copied from interface: CertificateSource

This method return the CertificatePool encapsulated by the source.

Specified by:

getCertificatePool in interface CertificateSource

Returns:

the certificate pool

addCertificate

public CertificateToken addCertificate(CertificateToken token)

This method adds an external certificate to the encapsulated pool and to the source. If the certificate is already present in the pool its source type is associated to the token.

Specified by:

addCertificate in interface CertificateSource

Parameters:

token - the certificate to add

Returns:

the corresponding certificate token

getCertificates

public List<CertificateToken> getCertificates()

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

Specified by:

getCertificates in interface CertificateSource

Returns:

all certificates from this source

get

public List<CertificateToken> get(X500Principal x500Principal)

This method returns the List of CertificateToken(s) corresponding to the given subject distinguished name. The content of the encapsulated certificates pool can be different from the content of the source.

Specified by:

get in interface CertificateSource

Parameters:

x500Principal - subject distinguished names of the certificate to find

Returns:

If no match is found then an empty list is returned.

removeCertificate

public boolean removeCertificate(CertificateToken certificate)

This method is used internally to remove a certificate from the CertificatePool.

Parameters:

certificate - the certificate to be removed

Returns:

true if removed

getNumberOfCertificates

public int getNumberOfCertificates()

This method returns the number of stored certificates in this source

Returns:

number of certificates in this instance