Package eu.europa.esig.dss.pades.validation.timestamp

Class PAdESTimestampSource

java.lang.Object

eu.europa.esig.dss.spi.validation.timestamp.AbstractTimestampSource

eu.europa.esig.dss.spi.validation.timestamp.SignatureTimestampSource<CAdESSignature,CAdESAttribute>

eu.europa.esig.dss.cades.validation.timestamp.CAdESTimestampSource

eu.europa.esig.dss.pades.validation.timestamp.PAdESTimestampSource

All Implemented Interfaces:

TimestampSource, Serializable

public class PAdESTimestampSource
extends CAdESTimestampSource

Extracts timestamps from a PAdES document

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected List<TimestampToken>	documentTimestamps	This variable contains the list of embedded document timestamps.
protected List<TimestampToken>	vriTimestamps	This variable contains the list of embedded /VRI timestamps corresponding to the signature.

Fields inherited from class eu.europa.esig.dss.spi.validation.timestamp.SignatureTimestampSource

archiveTimestamps, certificateSource, contentTimestamps, crlSource, detachedEvidenceRecords, detachedTimestamps, embeddedEvidenceRecords, ocspSource, refsOnlyTimestamps, sigAndRefsTimestamps, signature, signatureTimestamps, unsignedPropertiesReferences

Constructor Summary

Constructors

Constructor	Description
PAdESTimestampSource(PAdESSignature signature, List<PdfRevision> documentRevisions)	The default constructor to extract timestamps for a signature

Method Summary

Modifier and Type	Method	Description
protected List<TimestampedReference>	getAdbeRevocationInfoArchivalReferences()	Returns a list of revocation data TimestampedReferences from the adbe-revocationInfoArchival signed attribute
List<TimestampToken>	getAllTimestamps()	Returns a list of all incorporated timestamps
protected List<AdvancedSignature>	getCounterSignatures(CAdESAttribute unsignedAttribute)	Extracts Counter Signatures from the given unsignedAttribute
List<TimestampToken>	getDocumentTimestamps()	Returns a list of incorporated document timestamps (PAdES only)
protected List<TimestampedReference>	getSignatureTimestampReferences()	Returns a list of TimestampedReference for a "signature-timestamp" element
protected List<SignatureScope>	getTimestampScopes(TimestampToken timestampToken)	Generates timestamp token scopes
List<TimestampToken>	getVriTimestamps()	Returns a list of incorporated /VRI timestamps for the corresponding signature
protected boolean	isAdbeRevocationInfoArchival(CAdESAttribute signedAttribute)	Checks if the signedAttribute is an instance of type adbe-revocationInfoArchival
protected boolean	isArchiveTimestamp(CAdESAttribute unsignedAttribute)	Determines if the given unsignedAttribute is an instance of "archive-timestamp" element
protected boolean	isAttributeCertificateRef(CAdESAttribute unsignedAttribute)	Determines if the given unsignedAttribute is an instance of "attribute-certificate-ref" element
protected boolean	isAttributeRevocationRef(CAdESAttribute unsignedAttribute)	Determines if the given unsignedAttribute is an instance of "attribute-revocation-ref" element
protected boolean	isCertificateValues(CAdESAttribute unsignedAttribute)	Determines if the given unsignedAttribute is an instance of "certificate-values" element
protected boolean	isCompleteCertificateRef(CAdESAttribute unsignedAttribute)	Determines if the given unsignedAttribute is an instance of "complete-certificate-ref" element
protected boolean	isCompleteRevocationRef(CAdESAttribute unsignedAttribute)	Determines if the given unsignedAttribute is an instance of "complete-revocation-ref" element
protected boolean	isRefsOnlyTimestamp(CAdESAttribute unsignedAttribute)	Determines if the given unsignedAttribute is an instance of "refs-only-timestamp" element
protected boolean	isRevocationValues(CAdESAttribute unsignedAttribute)	Determines if the given unsignedAttribute is an instance of "revocation-values" element
protected boolean	isSigAndRefsTimestamp(CAdESAttribute unsignedAttribute)	Determines if the given unsignedAttribute is an instance of "sig-and-refs-timestamp" element
protected void	makeTimestampTokensFromSignedAttributes()	Creates TimestampTokens from all instances extracted from signed attributes (content TSTs)
protected void	makeTimestampTokensFromUnsignedAttributes()	Creates TimestampTokens from found instances in unsigned properties
protected void	validateTimestamps()	Validates list of all timestamps present in the source

Methods inherited from class eu.europa.esig.dss.cades.validation.timestamp.CAdESTimestampSource

buildCRLIdentifiers, buildOCSPIdentifiers, buildSignedSignatureProperties, buildUnsignedSignatureProperties, getArchiveTimestampReferences, getArchiveTimestampType, getCertificateRefs, getCounterSignatureReferences, getCRLRefs, getEncapsulatedCertificateIdentifiers, getEncapsulatedCRLIdentifiers, getEncapsulatedOCSPIdentifiers, getOCSPRefs, getSignatureSignedDataReferences, getTimestampMessageImprintDigestBuilder, getTimestampMessageImprintDigestBuilder, incorporateArchiveTimestampReferences, isAllDataObjectsTimestamp, isAttrAuthoritiesCertValues, isAttributeRevocationValues, isContentTimestamp, isCounterSignature, isEvidenceRecord, isIndividualDataObjectsTimestamp, isSignaturePolicyStore, isSignatureTimestamp, isTimeStampValidationData, makeEvidenceRecords, makeTimestampToken

Methods inherited from class eu.europa.esig.dss.spi.validation.timestamp.SignatureTimestampSource

addExternalEvidenceRecord, addExternalTimestamp, createAndValidate, getAllEvidenceRecords, getAllTimestampsExceptLastArchiveTimestamp, getArchiveTimestamps, getAttributeOrder, getContentTimestamps, getCounterSignaturesReferences, getDetachedEvidenceRecords, getDetachedTimestamps, getEmbeddedEvidenceRecords, getEncapsulatedReferencesFromTimestamps, getKeyInfoReferences, getSignatureReference, getSignatureTimestamps, getSignedSignatureProperties, getSignerDataReferences, getSigningCertificateTimestampReferences, getTimestampCertificateSources, getTimestampCertificateSourcesExceptLastArchiveTimestamp, getTimestampCRLSources, getTimestampedCertificateRefs, getTimestampedCertificateValues, getTimestampedRevocationRefs, getTimestampedRevocationValues, getTimestampOCSPSources, getTimestampsX1, getTimestampsX2, getTimestampValidationData, getUnsignedPropertiesReferences, getUnsignedSignatureProperties, isTimestamped, makeTimestampTokens, makeTimestampTokens, makeTimestampTokens, populateSources, populateSources, populateSources

Methods inherited from class eu.europa.esig.dss.spi.validation.timestamp.AbstractTimestampSource

addReference, addReference, addReferences, createReferenceForCertificate, createReferenceForIdentifier, createReferencesForCertificateRefs, createReferencesForCertificates, createReferencesForCRLBinaries, createReferencesForCRLRefs, createReferencesForIdentifiers, createReferencesForOCSPBinaries, createReferencesForOCSPBinary, createReferencesForOCSPRefs, getEncapsulatedValuesFromTimestamp, getReferencesFromTimestamp, getSignerDataTimestampedReferences, processEmbeddedEvidenceRecords, processEvidenceRecordTimestamps

Methods inherited from class java.lang.Object

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

Field Details

documentTimestamps

protected transient List<TimestampToken> documentTimestamps

This variable contains the list of embedded document timestamps.

vriTimestamps

protected transient List<TimestampToken> vriTimestamps

This variable contains the list of embedded /VRI timestamps corresponding to the signature.

Constructor Details

PAdESTimestampSource

public PAdESTimestampSource(PAdESSignature signature,
 List<PdfRevision> documentRevisions)

The default constructor to extract timestamps for a signature

Parameters:

signature - PAdESSignature to extract timestamps for

documentRevisions - a list of document PdfRevisions

Method Details

getDocumentTimestamps

public List<TimestampToken> getDocumentTimestamps()

Description copied from interface: TimestampSource

Returns a list of incorporated document timestamps (PAdES only)

Specified by:

getDocumentTimestamps in interface TimestampSource

Overrides:

getDocumentTimestamps in class SignatureTimestampSource<CAdESSignature,CAdESAttribute>

Returns:

a list of TimestampTokens

getVriTimestamps

public List<TimestampToken> getVriTimestamps()

Returns a list of incorporated /VRI timestamps for the corresponding signature

Returns:

a list of TimestampTokens

getAllTimestamps

public List<TimestampToken> getAllTimestamps()

Description copied from interface: TimestampSource

Returns a list of all incorporated timestamps

Specified by:

getAllTimestamps in interface TimestampSource

Overrides:

getAllTimestamps in class SignatureTimestampSource<CAdESSignature,CAdESAttribute>

Returns:

a list of TimestampTokens

makeTimestampTokensFromSignedAttributes

protected void makeTimestampTokensFromSignedAttributes()

Description copied from class: SignatureTimestampSource

Creates TimestampTokens from all instances extracted from signed attributes (content TSTs)

Overrides:

makeTimestampTokensFromSignedAttributes in class SignatureTimestampSource<CAdESSignature,CAdESAttribute>

makeTimestampTokensFromUnsignedAttributes

protected void makeTimestampTokensFromUnsignedAttributes()

Description copied from class: SignatureTimestampSource

Creates TimestampTokens from found instances in unsigned properties

Overrides:

makeTimestampTokensFromUnsignedAttributes in class SignatureTimestampSource<CAdESSignature,CAdESAttribute>

isCompleteCertificateRef

protected boolean isCompleteCertificateRef(CAdESAttribute unsignedAttribute)

Description copied from class: SignatureTimestampSource

Determines if the given unsignedAttribute is an instance of "complete-certificate-ref" element

Overrides:

isCompleteCertificateRef in class CAdESTimestampSource

Parameters:

unsignedAttribute - SignatureAttribute to process

Returns:

TRUE if the unsignedAttribute is a Complete Certificate Ref, FALSE otherwise

isAttributeCertificateRef

protected boolean isAttributeCertificateRef(CAdESAttribute unsignedAttribute)

Description copied from class: SignatureTimestampSource

Determines if the given unsignedAttribute is an instance of "attribute-certificate-ref" element

Overrides:

isAttributeCertificateRef in class CAdESTimestampSource

Parameters:

unsignedAttribute - SignatureAttribute to process

Returns:

TRUE if the unsignedAttribute is an Attribute Certificate Ref, FALSE otherwise

isCompleteRevocationRef

protected boolean isCompleteRevocationRef(CAdESAttribute unsignedAttribute)

Description copied from class: SignatureTimestampSource

Determines if the given unsignedAttribute is an instance of "complete-revocation-ref" element

Overrides:

isCompleteRevocationRef in class CAdESTimestampSource

Parameters:

unsignedAttribute - SignatureAttribute to process

Returns:

TRUE if the unsignedAttribute is a Complete Revocation Ref, FALSE otherwise

isAttributeRevocationRef

protected boolean isAttributeRevocationRef(CAdESAttribute unsignedAttribute)

Description copied from class: SignatureTimestampSource

Determines if the given unsignedAttribute is an instance of "attribute-revocation-ref" element

Overrides:

isAttributeRevocationRef in class CAdESTimestampSource

Parameters:

unsignedAttribute - SignatureAttribute to process

Returns:

TRUE if the unsignedAttribute is an Attribute Revocation Ref, FALSE otherwise

isRefsOnlyTimestamp

protected boolean isRefsOnlyTimestamp(CAdESAttribute unsignedAttribute)

Description copied from class: SignatureTimestampSource

Determines if the given unsignedAttribute is an instance of "refs-only-timestamp" element

Overrides:

isRefsOnlyTimestamp in class CAdESTimestampSource

Parameters:

unsignedAttribute - SignatureAttribute to process

Returns:

TRUE if the unsignedAttribute is a Refs Only TimeStamp, FALSE otherwise

isSigAndRefsTimestamp

protected boolean isSigAndRefsTimestamp(CAdESAttribute unsignedAttribute)

Description copied from class: SignatureTimestampSource

Determines if the given unsignedAttribute is an instance of "sig-and-refs-timestamp" element

Overrides:

isSigAndRefsTimestamp in class CAdESTimestampSource

Parameters:

unsignedAttribute - SignatureAttribute to process

Returns:

TRUE if the unsignedAttribute is a Sig And Refs TimeStamp, FALSE otherwise

isCertificateValues

protected boolean isCertificateValues(CAdESAttribute unsignedAttribute)

Description copied from class: SignatureTimestampSource

Determines if the given unsignedAttribute is an instance of "certificate-values" element

Overrides:

isCertificateValues in class CAdESTimestampSource

Parameters:

unsignedAttribute - SignatureAttribute to process

Returns:

TRUE if the unsignedAttribute is a Certificate Values, FALSE otherwise

isRevocationValues

protected boolean isRevocationValues(CAdESAttribute unsignedAttribute)

Description copied from class: SignatureTimestampSource

Determines if the given unsignedAttribute is an instance of "revocation-values" element

Overrides:

isRevocationValues in class CAdESTimestampSource

Parameters:

unsignedAttribute - SignatureAttribute to process

Returns:

TRUE if the unsignedAttribute is a Revocation Values, FALSE otherwise

isArchiveTimestamp

protected boolean isArchiveTimestamp(CAdESAttribute unsignedAttribute)

Description copied from class: SignatureTimestampSource

Determines if the given unsignedAttribute is an instance of "archive-timestamp" element

Overrides:

isArchiveTimestamp in class CAdESTimestampSource

Parameters:

unsignedAttribute - SignatureAttribute to process

Returns:

TRUE if the unsignedAttribute is an Archive TimeStamp, FALSE otherwise

validateTimestamps

protected void validateTimestamps()

Description copied from class: SignatureTimestampSource

Validates list of all timestamps present in the source

Overrides:

validateTimestamps in class SignatureTimestampSource<CAdESSignature,CAdESAttribute>

getTimestampScopes

protected List<SignatureScope> getTimestampScopes(TimestampToken timestampToken)

Description copied from class: SignatureTimestampSource

Generates timestamp token scopes

Overrides:

getTimestampScopes in class SignatureTimestampSource<CAdESSignature,CAdESAttribute>

Parameters:

timestampToken - TimestampToken to get timestamp sources for

Returns:

a list of SignatureScopes

getSignatureTimestampReferences

protected List<TimestampedReference> getSignatureTimestampReferences()

Description copied from class: SignatureTimestampSource

Returns a list of TimestampedReference for a "signature-timestamp" element

Overrides:

getSignatureTimestampReferences in class SignatureTimestampSource<CAdESSignature,CAdESAttribute>

Returns:

list of TimestampedReferences

getAdbeRevocationInfoArchivalReferences

protected List<TimestampedReference> getAdbeRevocationInfoArchivalReferences()

Returns a list of revocation data TimestampedReferences from the adbe-revocationInfoArchival signed attribute

Returns:

a list of TimestampedReferences

isAdbeRevocationInfoArchival

protected boolean isAdbeRevocationInfoArchival(CAdESAttribute signedAttribute)

Checks if the signedAttribute is an instance of type adbe-revocationInfoArchival

Parameters:

signedAttribute - CAdESAttribute to check

Returns:

TRUE if the attribute is an instance of type adbe-revocationInfoArchival, FALSE otherwise

getCounterSignatures

protected List<AdvancedSignature> getCounterSignatures(CAdESAttribute unsignedAttribute)

Description copied from class: SignatureTimestampSource

Extracts Counter Signatures from the given unsignedAttribute

Overrides:

getCounterSignatures in class CAdESTimestampSource

Parameters:

unsignedAttribute - SignatureTimestampSource containing counter signatures

Returns:

a list of AdvancedSignature containing counter signatures