Package eu.europa.esig.dss.xades.signature

Class XAdESService

java.lang.Object

eu.europa.esig.dss.signature.AbstractSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>

eu.europa.esig.dss.xades.signature.XAdESService

All Implemented Interfaces:

DocumentSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>, MultipleDocumentsSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>, Serializable

public class XAdESService
extends AbstractSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>
implements MultipleDocumentsSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>

XAdES implementation of DocumentSignatureService

See Also:

Serialized Form

Field Summary

Fields inherited from class eu.europa.esig.dss.signature.AbstractSignatureService

certificateVerifier, tspSource

Constructor Summary

Constructors

Constructor	Description
XAdESService(CertificateVerifier certificateVerifier)	This is the constructor to create an instance of the XAdESService.

Method Summary

Modifier and Type	Method	Description
DSSDocument	extendDocument(DSSDocument toExtendDocument, XAdESSignatureParameters parameters)	Extends the level of the signatures in the toExtendDocument
TimestampToken	getContentTimestamp(DSSDocument toSignDocument, XAdESSignatureParameters parameters)	This method allows to compute a content-timestamp (which is added in the signed properties)
TimestampToken	getContentTimestamp(List<DSSDocument> toSignDocuments, XAdESSignatureParameters parameters)	Creates a content-timestamp attribute (to be include in the signed-data)
ToBeSigned	getDataToSign(DSSDocument toSignDocument, XAdESSignatureParameters parameters)	Retrieves the bytes of the data that need to be signed based on the toSignDocument and parameters .
ToBeSigned	getDataToSign(List<DSSDocument> toSignDocuments, XAdESSignatureParameters parameters)	Retrieves the bytes of the data that need to be signed based on the toSignDocuments and parameters.
DSSDocument	signDocument(DSSDocument toSignDocument, XAdESSignatureParameters parameters, SignatureValue signatureValue)	Signs the toSignDocument with the provided signatureValue.
DSSDocument	signDocument(List<DSSDocument> toSignDocuments, XAdESSignatureParameters parameters, SignatureValue signatureValue)	Signs the toSignDocuments with the provided signatureValue.
DSSDocument	timestamp(List<DSSDocument> toTimestampDocuments, XAdESTimestampParameters parameters)	Timestamps the toSignDocuments with the provided signatureValue.

Methods inherited from class eu.europa.esig.dss.signature.AbstractSignatureService

assertSigningDateInCertificateValidityRange, getFinalArchiveName, getFinalFileName, setTspSource, timestamp

Methods inherited from class java.lang.Object

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

Constructor Details

XAdESService

public XAdESService(CertificateVerifier certificateVerifier)

This is the constructor to create an instance of the XAdESService. A certificate verifier must be provided.

Parameters:

certificateVerifier - CertificateVerifier provides information on the sources to be used in the validation process in the context of a signature.

Method Details

getContentTimestamp

public TimestampToken getContentTimestamp(DSSDocument toSignDocument, XAdESSignatureParameters parameters)

Description copied from interface: DocumentSignatureService

This method allows to compute a content-timestamp (which is added in the signed properties)

Specified by:

getContentTimestamp in interface DocumentSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>

Parameters:

toSignDocument - document to sign or the already existing signature

parameters - set of the driving signing parameters

Returns:

a timestamp token

getContentTimestamp

public TimestampToken getContentTimestamp(List<DSSDocument> toSignDocuments, XAdESSignatureParameters parameters)

Description copied from interface: MultipleDocumentsSignatureService

Creates a content-timestamp attribute (to be include in the signed-data)

Specified by:

getContentTimestamp in interface MultipleDocumentsSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>

Parameters:

toSignDocuments - list of documents to sign

parameters - set of the driving signing parameters

Returns:

a timestamp token

getDataToSign

public ToBeSigned getDataToSign(DSSDocument toSignDocument, XAdESSignatureParameters parameters) throws DSSException

Description copied from interface: DocumentSignatureService

Retrieves the bytes of the data that need to be signed based on the toSignDocument and parameters . When toSignDocument contains an already existing signature the returned bytes are related to a new parallel signature. - Enveloped signature (XML): a new signature is added and the signed data corresponds to that pointed by the first signature; - Enveloping signature: - - XML: The parallel signature is not possible - - CMS: A new parallel signature is added - Detached signature: - - XML: The parallel signature is added - - CMS: A new parallel signature is added

Specified by:

getDataToSign in interface DocumentSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>

Parameters:

toSignDocument - document to sign or the already existing signature

parameters - set of the driving signing parameters

Returns:

the data to be signed

Throws:

DSSException

getDataToSign

public ToBeSigned getDataToSign(List<DSSDocument> toSignDocuments, XAdESSignatureParameters parameters) throws DSSException

Description copied from interface: MultipleDocumentsSignatureService

Retrieves the bytes of the data that need to be signed based on the toSignDocuments and parameters. When toSignDocuments contains an already existing signature the returned bytes are related to a new parallel signature.

Specified by:

getDataToSign in interface MultipleDocumentsSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>

Parameters:

toSignDocuments - list of documents to sign

parameters - set of the driving signing parameters

Returns:

the data to be signed

Throws:

DSSException

signDocument

public DSSDocument signDocument(DSSDocument toSignDocument, XAdESSignatureParameters parameters, SignatureValue signatureValue) throws DSSException

Description copied from interface: DocumentSignatureService

Signs the toSignDocument with the provided signatureValue.

Specified by:

signDocument in interface DocumentSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>

Parameters:

toSignDocument - document to sign

parameters - set of the driving signing parameters

signatureValue - the signature value to incorporate

Returns:

the signed document (toSignDocument with the incorporated signature or the detached signature)

Throws:

DSSException

signDocument

public DSSDocument signDocument(List<DSSDocument> toSignDocuments, XAdESSignatureParameters parameters, SignatureValue signatureValue) throws DSSException

Description copied from interface: MultipleDocumentsSignatureService

Signs the toSignDocuments with the provided signatureValue.

Specified by:

signDocument in interface MultipleDocumentsSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>

Parameters:

toSignDocuments - list of documents to sign

parameters - set of the driving signing parameters

signatureValue - the signature value to incorporate

Returns:

the container with the signature and the documents (ASiC) or the signature file

Throws:

DSSException

extendDocument

public DSSDocument extendDocument(DSSDocument toExtendDocument, XAdESSignatureParameters parameters) throws DSSException

Description copied from interface: MultipleDocumentsSignatureService

Extends the level of the signatures in the toExtendDocument

Specified by:

extendDocument in interface DocumentSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>

Specified by:

extendDocument in interface MultipleDocumentsSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>

Parameters:

toExtendDocument - document to extend

parameters - set of the driving signing parameters

Returns:

the extended signature

Throws:

DSSException

timestamp

public DSSDocument timestamp(List<DSSDocument> toTimestampDocuments, XAdESTimestampParameters parameters)

Description copied from interface: MultipleDocumentsSignatureService

Timestamps the toSignDocuments with the provided signatureValue.

Specified by:

timestamp in interface MultipleDocumentsSignatureService<XAdESSignatureParameters,XAdESTimestampParameters>

Parameters:

toTimestampDocuments - list of documents to timestamp

parameters - set of the driving timestamping parameters

Returns:

the container with the added timestamp token