Package eu.europa.esig.dss.pdf.pdfbox

Class PdfBoxDocumentReader

java.lang.Object

eu.europa.esig.dss.pdf.pdfbox.PdfBoxDocumentReader

All Implemented Interfaces:

PdfDocumentReader, Closeable, AutoCloseable

public class PdfBoxDocumentReader
extends Object
implements PdfDocumentReader

The PDFBox implementation of PdfDocumentReader

Constructor Summary

Constructors

Constructor	Description
PdfBoxDocumentReader(byte[] binaries, String passwordProtection)	The PDFBox implementation of the Reader
PdfBoxDocumentReader(DSSDocument dssDocument)	Default constructor of the PDFBox implementation of the Reader
PdfBoxDocumentReader(DSSDocument dssDocument, String passwordProtection)	The PDFBox implementation of the Reader
PdfBoxDocumentReader(org.apache.pdfbox.pdmodel.PDDocument pdDocument)	The constructor to directly instantiate the PdfBoxDocumentReader

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
org.apache.pdfbox.pdmodel.PDPage	getPDPage(int page)	Returns a PDPage
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

PdfBoxDocumentReader

public PdfBoxDocumentReader(DSSDocument dssDocument)
                     throws IOException,
InvalidPasswordException

Default constructor of the PDFBox 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

PdfBoxDocumentReader

public PdfBoxDocumentReader(DSSDocument dssDocument,
String passwordProtection)
                     throws IOException,
InvalidPasswordException

The PDFBox implementation of the Reader

Parameters:

dssDocument - DSSDocument to read

passwordProtection - String 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

PdfBoxDocumentReader

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

The PDFBox implementation of the Reader

Parameters:

binaries - a byte array of a PDF to read

passwordProtection - String 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

PdfBoxDocumentReader

public PdfBoxDocumentReader(org.apache.pdfbox.pdmodel.PDDocument pdDocument)

The constructor to directly instantiate the PdfBoxDocumentReader

Parameters:

pdDocument - PDDocument

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()
                                                                throws IOException

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

Throws:

IOException - if an exception occurs

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

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException

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)
                                      throws IOException

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

Throws:

IOException - if an exception occurs

getPDPage

public org.apache.pdfbox.pdmodel.PDPage getPDPage(int page)

Returns a PDPage

Parameters:

page - number

Returns:

PDPage

generateImageScreenshot

public BufferedImage generateImageScreenshot(int page)
                                      throws IOException

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

Throws:

IOException - if an exception occurs

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