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

Class ITextDocumentReader

java.lang.Object

eu.europa.esig.dss.pdf.openpdf.ITextDocumentReader

All Implemented Interfaces:

PdfDocumentReader, Closeable, AutoCloseable

public class ITextDocumentReader
extends Object
implements PdfDocumentReader

The IText (OpenPdf) implementation of PdfDocumentReader

Constructor Summary

Constructors

Constructor	Description
ITextDocumentReader(byte[] binaries, byte[] passwordProtection)	The OpenPDF implementation of the Reader
ITextDocumentReader(com.lowagie.text.pdf.PdfReader pdfReader)	The constructor to directly instantiate the ITextDocumentReader
ITextDocumentReader(DSSDocument dssDocument)	Default constructor of the OpenPDF implementation of the Reader
ITextDocumentReader(DSSDocument dssDocument, byte[] passwordProtection)	The OpenPDF implementation of the Reader

Method Summary

Modifier and Type	Method	Description
void	close()
Map<PdfSignatureDictionary,List<String>>	extractSigDictionaries()	Extracts PdfSignatureDictionaries present in the signature
BufferedImage	generateImageScreenshot(int page)	Generates the image screenshot for the given page of the PDF
BufferedImage	generateImageScreenshotWithoutAnnotations(int page, List<PdfAnnotation> annotations)	Generates the image screenshot by hiding the given list of annotationBoxes
PdfDssDict	getDSSDictionary()	Loads the last DSS dictionary from the document if exists NOTE: can return null if DSS dictionary is not present
int	getNumberOfPages()	Returns an amount of pages found in the document
AnnotationBox	getPageBox(int page)	Returns a page box dimensions
List<PdfAnnotation>	getPdfAnnotations(int page)	Retrieves all annotations found in the document
boolean	isSignatureCoversWholeDocument(PdfSignatureDictionary signatureDictionary)	Checks if a signature for the given PDF Signature Dictionary covers the whole document

Methods inherited from class java.lang.Object

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

Constructor Details

ITextDocumentReader

public ITextDocumentReader(DSSDocument dssDocument)
                    throws IOException,
InvalidPasswordException

Default constructor of the OpenPDF implementation of the Reader

Parameters:

dssDocument - DSSDocument to read

Throws:

IOException - if an exception occurs

InvalidPasswordException - if the password is not provided or invalid for a protected document

ITextDocumentReader

public ITextDocumentReader(DSSDocument dssDocument,
byte[] passwordProtection)
                    throws IOException,
InvalidPasswordException

The OpenPDF implementation of the Reader

Parameters:

dssDocument - DSSDocument to read

passwordProtection - binaries of a password to open a protected document

Throws:

IOException - if an exception occurs

InvalidPasswordException - if the password is not provided or invalid for a protected document

ITextDocumentReader

public ITextDocumentReader(byte[] binaries,
byte[] passwordProtection)
                    throws IOException,
InvalidPasswordException

The OpenPDF implementation of the Reader

Parameters:

binaries - a byte array of a PDF to read

passwordProtection - binaries of a password to open a protected document

Throws:

IOException - if an exception occurs

InvalidPasswordException - if the password is not provided or invalid for a protected document

ITextDocumentReader

public ITextDocumentReader(com.lowagie.text.pdf.PdfReader pdfReader)

The constructor to directly instantiate the ITextDocumentReader

Parameters:

pdfReader - PdfReader

Method Details

getDSSDictionary

public PdfDssDict getDSSDictionary()

Description copied from interface: PdfDocumentReader

Loads the last DSS dictionary from the document if exists NOTE: can return null if DSS dictionary is not present

Specified by:

getDSSDictionary in interface PdfDocumentReader

Returns:

PdfDssDict

extractSigDictionaries

public Map<PdfSignatureDictionary,List<String>> extractSigDictionaries()

Description copied from interface: PdfDocumentReader

Extracts PdfSignatureDictionaries present in the signature

Specified by:

extractSigDictionaries in interface PdfDocumentReader

Returns:

a map between PdfSignatureDictionary and related field names

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

isSignatureCoversWholeDocument

public boolean isSignatureCoversWholeDocument(PdfSignatureDictionary signatureDictionary)

Description copied from interface: PdfDocumentReader

Checks if a signature for the given PDF Signature Dictionary covers the whole document

Specified by:

isSignatureCoversWholeDocument in interface PdfDocumentReader

Parameters:

signatureDictionary - PdfSignatureDictionary to check the result for

Returns:

TRUE if the signature covers the whole document, false otherwise

getNumberOfPages

public int getNumberOfPages()

Description copied from interface: PdfDocumentReader

Returns an amount of pages found in the document

Specified by:

getNumberOfPages in interface PdfDocumentReader

Returns:

number of pages

getPageBox

public AnnotationBox getPageBox(int page)

Description copied from interface: PdfDocumentReader

Returns a page box dimensions

Specified by:

getPageBox in interface PdfDocumentReader

Parameters:

page - number

Returns:

AnnotationBox representing page dimensions

getPdfAnnotations

public List<PdfAnnotation> getPdfAnnotations(int page)

Description copied from interface: PdfDocumentReader

Retrieves all annotations found in the document

Specified by:

getPdfAnnotations in interface PdfDocumentReader

Parameters:

page - number

Returns:

a list of PdfAnnotations associated with the given page

generateImageScreenshot

public BufferedImage generateImageScreenshot(int page)

Description copied from interface: PdfDocumentReader

Generates the image screenshot for the given page of the PDF

Specified by:

generateImageScreenshot in interface PdfDocumentReader

Parameters:

page - number to be generated

Returns:

BufferedImage screenshot for the given page

generateImageScreenshotWithoutAnnotations

public BufferedImage generateImageScreenshotWithoutAnnotations(int page,
List<PdfAnnotation> annotations)
                                                        throws IOException

Description copied from interface: PdfDocumentReader

Generates the image screenshot by hiding the given list of annotationBoxes

Specified by:

generateImageScreenshotWithoutAnnotations in interface PdfDocumentReader

Parameters:

page - number to be generated

annotations - a list of PdfAnnotations to be hidden

Returns:

BufferedImage screenshot for the given page

Throws:

IOException - if an exception occurs