Package eu.europa.esig.dss.pdf.openpdf

Class ITextPDFSignatureService

java.lang.Object

eu.europa.esig.dss.pdf.AbstractPDFSignatureService

eu.europa.esig.dss.pdf.openpdf.ITextPDFSignatureService

All Implemented Interfaces:

PDFSignatureService

public class ITextPDFSignatureService
extends AbstractPDFSignatureService

Implementation of PDFSignatureService using iText

Field Summary

Fields inherited from class eu.europa.esig.dss.pdf.AbstractPDFSignatureService

pdfDifferencesFinder, pdfObjectModificationsFinder, resourcesHandlerBuilder

Constructor Summary

Constructors

Constructor	Description
ITextPDFSignatureService(PDFServiceMode serviceMode, ITextSignatureDrawerFactory signatureDrawerFactory)	Constructor for the ITextPDFSignatureService

Method Summary

Modifier and Type	Method	Description
DSSDocument	addDssDictionary(DSSDocument document, PdfValidationDataContainer validationDataForInclusion, String pwd)	This method adds the DSS dictionary (Baseline-LT) to a password-protected document
DSSDocument	addNewSignatureField(DSSDocument document, SignatureFieldParameters parameters, String pwd)	This method allows to add a new signature field to an existing encrypted pdf document
protected void	checkSignatureFieldAgainstPageDimensions(AnnotationBox signatureFieldBox, AnnotationBox pageBox, int pageRotation)	This method verifies whether the signatureFieldBox is within pageBox
protected byte[]	computeDigest(DSSDocument toSignDocument, PAdESCommonParameters parameters)	Computes digest on to be signed data computed on the toSignDocument respectively to the given parameters
List<String>	getAvailableSignatureFields(DSSDocument document, String pwd)	Returns not-signed signature fields from an encrypted document
protected List<PdfModification>	getVisualDifferences(PdfDocumentReader signedRevisionReader, PdfDocumentReader finalRevisionReader)	Returns a list of visual differences between the provided PDF and the signed content
protected PdfDocumentReader	loadPdfDocumentReader(byte[] binaries, String passwordProtection)	Loads PdfDocumentReader instance
protected PdfDocumentReader	loadPdfDocumentReader(DSSDocument dssDocument, String passwordProtection)	Loads PdfDocumentReader instance
DSSDocument	previewPageWithVisualSignature(DSSDocument toSignDocument, PAdESCommonParameters parameters)	Returns a page preview with the visual signature
DSSDocument	previewSignatureField(DSSDocument toSignDocument, PAdESCommonParameters parameters)	Returns a preview of the signature field
protected DSSDocument	signDocument(DSSDocument toSignDocument, byte[] cmsSignedData, PAdESCommonParameters parameters)	This method creates a signed document from the original toSignDocument, incorporating a new revision, enveloping the provided cmsSignedData
protected AnnotationBox	toPdfPageCoordinates(AnnotationBox fieldAnnotationBox, AnnotationBox pageBox, int rotation)	This method transforms a fieldAnnotationBox's positions and dimensions according to the given page

Methods inherited from class eu.europa.esig.dss.pdf.AbstractPDFSignatureService

addDssDictionary, addNewSignatureField, analyzePdfModifications, buildSignatureFieldBox, checkDocumentPermissions, checkNewSignatureIsPermitted, checkSignatureFieldBoxOverlap, digest, extractBeforeSignatureValue, getAvailableSignatureFields, getRevisions, getSignatureValue, getType, getVisibleSignatureFieldBoxPosition, getVisibleSignatureFieldBoxPosition, instantiateResourcesHandler, isContentValueEqualsByteRangeExtraction, isDocTimestamp, isDocumentTimestampLayer, isSignature, loadSignatureDrawer, setAlertOnForbiddenSignatureCreation, setAlertOnSignatureFieldOutsidePageDimensions, setAlertOnSignatureFieldOverlap, setMaximalPagesAmountForVisualComparison, setPdfDifferencesFinder, setPdfObjectModificationsFinder, setResourcesHandlerBuilder, sign

Methods inherited from class java.lang.Object

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

Constructor Details

ITextPDFSignatureService

public ITextPDFSignatureService(PDFServiceMode serviceMode,
 ITextSignatureDrawerFactory signatureDrawerFactory)

Constructor for the ITextPDFSignatureService

Parameters:

serviceMode - current instance is used to generate a DocumentTimestamp or Signature signature layer

signatureDrawerFactory - drawer factory implementation to be used

Method Details

computeDigest

protected byte[] computeDigest(DSSDocument toSignDocument,
 PAdESCommonParameters parameters)

Description copied from class: AbstractPDFSignatureService

Computes digest on to be signed data computed on the toSignDocument respectively to the given parameters

Specified by:

computeDigest in class AbstractPDFSignatureService

Parameters:

toSignDocument - DSSDocument to be signed

parameters - PAdESCommonParameters

Returns:

byte array

signDocument

protected DSSDocument signDocument(DSSDocument toSignDocument,
 byte[] cmsSignedData,
 PAdESCommonParameters parameters)

Description copied from class: AbstractPDFSignatureService

This method creates a signed document from the original toSignDocument, incorporating a new revision, enveloping the provided cmsSignedData

Specified by:

signDocument in class AbstractPDFSignatureService

Parameters:

toSignDocument - DSSDocument to be signed

cmsSignedData - byte array representing the encoded CMS signed data's binaries

parameters - PAdESCommonParameters

Returns:

DSSDocument

addDssDictionary

public DSSDocument addDssDictionary(DSSDocument document,
 PdfValidationDataContainer validationDataForInclusion,
 String pwd)

Description copied from interface: PDFSignatureService

This method adds the DSS dictionary (Baseline-LT) to a password-protected document

Parameters:

document - the document to be extended

validationDataForInclusion - PdfValidationDataContainer

pwd - the password protection used to create the encrypted document (optional)

Returns:

the pdf document with the added dss dictionary

getAvailableSignatureFields

public List<String> getAvailableSignatureFields(DSSDocument document,
 String pwd)

Description copied from interface: PDFSignatureService

Returns not-signed signature fields from an encrypted document

Parameters:

document - the pdf document

pwd - the password protection phrase used to encrypt the document

Returns:

the list of not signed signature field names

addNewSignatureField

public DSSDocument addNewSignatureField(DSSDocument document,
 SignatureFieldParameters parameters,
 String pwd)

Description copied from interface: PDFSignatureService

This method allows to add a new signature field to an existing encrypted pdf document

Parameters:

document - the pdf document

parameters - the parameters with the coordinates,... of the signature field

pwd - the password protection used to create the encrypted document (optional)

Returns:

the pdf document with the new added signature field

toPdfPageCoordinates

protected AnnotationBox toPdfPageCoordinates(AnnotationBox fieldAnnotationBox,
 AnnotationBox pageBox,
 int rotation)

Description copied from class: AbstractPDFSignatureService

This method transforms a fieldAnnotationBox's positions and dimensions according to the given page

Overrides:

toPdfPageCoordinates in class AbstractPDFSignatureService

Parameters:

fieldAnnotationBox - AnnotationBox computed field of a signature

pageBox - AnnotationBox page's box

rotation - defines the page's rotation

Returns:

AnnotationBox

checkSignatureFieldAgainstPageDimensions

protected void checkSignatureFieldAgainstPageDimensions(AnnotationBox signatureFieldBox,
 AnnotationBox pageBox,
 int pageRotation)

Description copied from class: AbstractPDFSignatureService

This method verifies whether the signatureFieldBox is within pageBox

Overrides:

checkSignatureFieldAgainstPageDimensions in class AbstractPDFSignatureService

Parameters:

signatureFieldBox - AnnotationBox to check

pageBox - AnnotationBox representing the page's box

pageRotation - defines the page's rotation

previewPageWithVisualSignature

public DSSDocument previewPageWithVisualSignature(DSSDocument toSignDocument,
 PAdESCommonParameters parameters)

Description copied from interface: PDFSignatureService

Returns a page preview with the visual signature

Parameters:

toSignDocument - the document to be signed

parameters - the signature/timestamp parameters

Returns:

a DSSDocument with the PNG picture

previewSignatureField

public DSSDocument previewSignatureField(DSSDocument toSignDocument,
 PAdESCommonParameters parameters)

Description copied from interface: PDFSignatureService

Returns a preview of the signature field

Parameters:

toSignDocument - the document to be signed

parameters - the signature/timestamp parameters

Returns:

a DSSDocument with the PNG picture

loadPdfDocumentReader

protected PdfDocumentReader loadPdfDocumentReader(DSSDocument dssDocument,
 String passwordProtection)
                                           throws IOException

Description copied from class: AbstractPDFSignatureService

Loads PdfDocumentReader instance

Specified by:

loadPdfDocumentReader in class AbstractPDFSignatureService

Parameters:

dssDocument - DSSDocument to read

passwordProtection - String the password used to protect the document

Returns:

PdfDocumentReader

Throws:

IOException - in case of loading error

loadPdfDocumentReader

protected PdfDocumentReader loadPdfDocumentReader(byte[] binaries,
 String passwordProtection)
                                           throws IOException

Description copied from class: AbstractPDFSignatureService

Loads PdfDocumentReader instance

Specified by:

loadPdfDocumentReader in class AbstractPDFSignatureService

Parameters:

binaries - a byte array

passwordProtection - String the password used to protect the document

Returns:

PdfDocumentReader

Throws:

IOException - in case of loading error

getVisualDifferences

protected List<PdfModification> getVisualDifferences(PdfDocumentReader signedRevisionReader,
 PdfDocumentReader finalRevisionReader)

Description copied from class: AbstractPDFSignatureService

Returns a list of visual differences between the provided PDF and the signed content

Overrides:

getVisualDifferences in class AbstractPDFSignatureService

Parameters:

signedRevisionReader - PdfDocumentReader for the signed revision content

finalRevisionReader - PdfDocumentReader for the input PDF document

Returns:

a list of PdfModifications