Package eu.europa.esig.dss.spi.x509

Class CommonCertificateSource

java.lang.Object

eu.europa.esig.dss.spi.x509.CommonCertificateSource

All Implemented Interfaces:

CertificateSource, Serializable

Direct Known Subclasses:

AIACertificateSource, CommonTrustedCertificateSource, KeyStoreCertificateSource, TokenCertificateSource

public class CommonCertificateSource
extends Object
implements CertificateSource

This class is the common class for all CertificateSource. It stores added certificates and allows to retrieve them with several methods

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
CommonCertificateSource()	The default constructor

Method Summary

Modifier and Type	Method	Description
CertificateToken	addCertificate(CertificateToken certificateToAdd)	This method adds an external certificate to the source.
Set<CertificateToken>	getByCertificateIdentifier(CertificateIdentifier certificateIdentifier)	This method returns the Set of certificates with the CertificateIdentifier
Set<CertificateToken>	getByPublicKey(PublicKey publicKey)	This method returns a list of CertificateToken with the given PublicKey
Set<CertificateToken>	getBySki(byte[] ski)	This method returns a list of CertificateToken with the given SKI (SubjectKeyIdentifier (SHA-1 of the PublicKey))
Set<CertificateToken>	getBySubject(X500PrincipalHelper subject)	This method returns the Set of certificates with the same subjectDN.
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.
List<eu.europa.esig.dss.spi.x509.CertificateSourceEntity>	getEntities()
int	getNumberOfCertificates()	This method returns the number of stored certificates in this source
int	getNumberOfEntities()	This method returns the number of stored entities (unique public key) in this source
boolean	isAllSelfSigned()	This method checks if all certificates are self-signed
boolean	isKnown(CertificateToken token)	This method checks if a given certificate is known in the current source
boolean	isTrusted(CertificateToken certificateToken)	This method checks if a given certificate is trusted
protected void	reset()

Methods inherited from class java.lang.Object

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

Constructor Details

CommonCertificateSource

public CommonCertificateSource()

The default constructor

Method Details

addCertificate

public CertificateToken addCertificate(CertificateToken certificateToAdd)

This method adds an external certificate to the source. If the public is already known, the certificate is merged in the CertificateSourceEntity

Specified by:

addCertificate in interface CertificateSource

Parameters:

certificateToAdd - the certificate to be added

Returns:

the corresponding certificate token

reset

protected void reset()

isKnown

public boolean isKnown(CertificateToken token)

Description copied from interface: CertificateSource

This method checks if a given certificate is known in the current source

Specified by:

isKnown in interface CertificateSource

Parameters:

token - the certificate to be tested

Returns:

true if the certificate is part of the current source

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

getEntities

public List<eu.europa.esig.dss.spi.x509.CertificateSourceEntity> getEntities()

Specified by:

getEntities in interface CertificateSource

getByPublicKey

public Set<CertificateToken> getByPublicKey(PublicKey publicKey)

This method returns a list of CertificateToken with the given PublicKey

Specified by:

getByPublicKey in interface CertificateSource

Parameters:

publicKey - the public key to find

Returns:

a list of CertificateToken which have the given public key

getBySki

public Set<CertificateToken> getBySki(byte[] ski)

This method returns a list of CertificateToken with the given SKI (SubjectKeyIdentifier (SHA-1 of the PublicKey))

Specified by:

getBySki in interface CertificateSource

Parameters:

ski - the Subject Key Identifier

Returns:

a list of CertificateToken which have the given ski

getBySubject

public Set<CertificateToken> getBySubject(X500PrincipalHelper subject)

This method returns the Set of certificates with the same subjectDN.

Specified by:

getBySubject in interface CertificateSource

Parameters:

subject - the subject to match

Returns:

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

getByCertificateIdentifier

public Set<CertificateToken> getByCertificateIdentifier(CertificateIdentifier certificateIdentifier)

Description copied from interface: CertificateSource

This method returns the Set of certificates with the CertificateIdentifier

Specified by:

getByCertificateIdentifier in interface CertificateSource

Parameters:

certificateIdentifier - the certificate identifier to match

Returns:

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

getNumberOfCertificates

public int getNumberOfCertificates()

This method returns the number of stored certificates in this source

Returns:

number of certificates in this instance

getNumberOfEntities

public int getNumberOfEntities()

This method returns the number of stored entities (unique public key) in this source

Returns:

number of entities in this instance

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

isTrusted

public boolean isTrusted(CertificateToken certificateToken)

Description copied from interface: CertificateSource

This method checks if a given certificate is trusted

Specified by:

isTrusted in interface CertificateSource

Parameters:

certificateToken - the certificate to be tested

Returns:

true if the certificate is trusted

isAllSelfSigned

public boolean isAllSelfSigned()

Description copied from interface: CertificateSource

This method checks if all certificates are self-signed

Specified by:

isAllSelfSigned in interface CertificateSource

Returns:

true if all certificates are self-signed