eu.europa.esig.dss.validation

Class SignatureValidationContext

java.lang.Object

eu.europa.esig.dss.validation.SignatureValidationContext

All Implemented Interfaces:

ValidationContext

public class SignatureValidationContext
extends Object
implements ValidationContext

During the validation of a signature, the software retrieves different X509 artifacts like Certificate, CRL and OCSP Response. The SignatureValidationContext is a "cache" for one validation request that contains every object retrieved so far.

Field Summary

Fields

Modifier and Type	Field and Description
protected Date	currentTime This is the time at what the validation is carried out.
protected CertificatePool	validationCertificatePool The certificate pool which encapsulates all certificates used during the validation process and extracted from all used sources

Constructor Summary

Constructors

Constructor and Description
SignatureValidationContext() This constructor is used during the signature creation process.
SignatureValidationContext(CertificatePool validationCertificatePool) This constructor is used when a signature need to be validated.

Method Summary

Methods

Modifier and Type	Method and Description
void	addCertificateTokenForVerification(CertificateToken certificateToken) Adds a new certificate token to the list of tokens to verify.
void	addRevocationTokensForVerification(List<RevocationToken> revocationTokens) Adds a list of new revocation tokens to the list of tokens to verify.
void	addTimestampTokenForVerification(TimestampToken timestampToken) Adds a new timestamp token to the list of tokens to verify.
Date	getCurrentTime()
Set<CertificateToken>	getProcessedCertificates() Returns a read only list of all certificates used in the process of the validation of all signatures from the given document.
Set<RevocationToken>	getProcessedRevocations() Returns a read only list of all revocations used in the process of the validation of all signatures from the given document.
Set<TimestampToken>	getProcessedTimestamps() Returns a read only list of all timestamps processed during the validation of all signatures from the given document.
void	initialize(CertificateVerifier certificateVerifier)
void	setCurrentTime(Date currentTime) This function sets the validation time.
String	toString()
String	toString(String indentStr) This method returns the human readable representation of the ValidationContext.
void	validate() Carries out the validation process in recursive manner for not yet checked tokens.

Methods inherited from class java.lang.Object

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

Field Detail

validationCertificatePool

protected CertificatePool validationCertificatePool

The certificate pool which encapsulates all certificates used during the validation process and extracted from all used sources

currentTime

protected Date currentTime

This is the time at what the validation is carried out. It is used only for test purpose.

Constructor Detail

SignatureValidationContext

public SignatureValidationContext()

This constructor is used during the signature creation process. The certificate pool is created within initialize method.

SignatureValidationContext

public SignatureValidationContext(CertificatePool validationCertificatePool)

This constructor is used when a signature need to be validated.

Parameters:

validationCertificatePool - The pool of certificates used during the validation process

Method Detail

initialize

public void initialize(CertificateVerifier certificateVerifier)

Specified by:

initialize in interface ValidationContext

Parameters:

certificateVerifier - The certificates verifier (eg: using the TSL as list of trusted certificates).

getCurrentTime

public Date getCurrentTime()

Specified by:

getCurrentTime in interface ValidationContext

setCurrentTime

public void setCurrentTime(Date currentTime)

Description copied from interface: ValidationContext

This function sets the validation time.

Specified by:

setCurrentTime in interface ValidationContext

Parameters:

currentTime - Date

addRevocationTokensForVerification

public void addRevocationTokensForVerification(List<RevocationToken> revocationTokens)

Description copied from interface: ValidationContext

Adds a list of new revocation tokens to the list of tokens to verify. If the revocation token has already been added then it is ignored.

Specified by:

addRevocationTokensForVerification in interface ValidationContext

addCertificateTokenForVerification

public void addCertificateTokenForVerification(CertificateToken certificateToken)

Description copied from interface: ValidationContext

Adds a new certificate token to the list of tokens to verify. If the certificate token has already been added then it is ignored.

Specified by:

addCertificateTokenForVerification in interface ValidationContext

Parameters:

certificateToken - CertificateToken certificate token to verify

addTimestampTokenForVerification

public void addTimestampTokenForVerification(TimestampToken timestampToken)

Description copied from interface: ValidationContext

Adds a new timestamp token to the list of tokens to verify. If the timestamp token has already been added then it is ignored.

Specified by:

addTimestampTokenForVerification in interface ValidationContext

Parameters:

timestampToken - TimestampToken timestamp token to verify

validate

public void validate()
              throws DSSException

Description copied from interface: ValidationContext

Carries out the validation process in recursive manner for not yet checked tokens.

Specified by:

validate in interface ValidationContext

Throws:

DSSException

getProcessedCertificates

public Set<CertificateToken> getProcessedCertificates()

Description copied from interface: ValidationContext

Returns a read only list of all certificates used in the process of the validation of all signatures from the given document. This list includes the certificate to check, certification chain certificates, OCSP response certificate...

Specified by:

getProcessedCertificates in interface ValidationContext

Returns:

The list of CertificateToken(s)

getProcessedRevocations

public Set<RevocationToken> getProcessedRevocations()

Description copied from interface: ValidationContext

Returns a read only list of all revocations used in the process of the validation of all signatures from the given document.

Specified by:

getProcessedRevocations in interface ValidationContext

Returns:

The list of CertificateToken(s)

getProcessedTimestamps

public Set<TimestampToken> getProcessedTimestamps()

Description copied from interface: ValidationContext

Returns a read only list of all timestamps processed during the validation of all signatures from the given document.

Specified by:

getProcessedTimestamps in interface ValidationContext

Returns:

The list of CertificateToken(s)

toString

public String toString(String indentStr)

This method returns the human readable representation of the ValidationContext.

Parameters:

indentStr -

Returns:

toString

public String toString()

Overrides:

toString in class Object