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
boolean	canCreateSignatureField()	This method verifies whether creation of new signature fields is allowed by the PDF permissions dictionary
boolean	canFillSignatureForm()	This method verifies whether fill-in of existing signature fields is allowed by PDF document permissions dictionary
void	checkDocumentPermissions()	Deprecated.
void	close()
Map<PdfSignatureDictionary,List<PdfSignatureField>>	extractSigDictionaries()	Extracts PdfSignatureDictionaries present in the signature
long	generateDocumentId(PAdESCommonParameters parameters)	Computes a DocumentId in a deterministic way based on the given parameters and the document
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
PdfDict	getCatalogDictionary()	Returns a document catalog as a dictionary
CertificationPermission	getCertificationPermission()	Returns value of /DocMDP dictionary defining the permitted modification in a PDF, when present
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
int	getPageRotation(int page)	This method returns a corresponding page's rotation within the document
org.apache.pdfbox.pdmodel.PDDocument	getPDDocument()	Returns the current instance of PDDocument
List<PdfAnnotation>	getPdfAnnotations(int page)	Retrieves all annotations found in the document
org.apache.pdfbox.pdmodel.PDPage	getPDPage(int page)	Returns a PDPage
boolean	isEncrypted()	This method checks whether the document is encrypted
boolean	isOpenWithOwnerAccess()	This method verifies if the document has been opened with a full owner access (all modifications are permitted)
boolean	isSignatureCoversWholeDocument(PdfSignatureDictionary signatureDictionary)	Checks if a signature for the given PDF Signature Dictionary covers the whole document
boolean	isUsageRightsSignaturePresent()	This method verifies whether a PDF contains a usage rights signature

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

getPDDocument

public org.apache.pdfbox.pdmodel.PDDocument getPDDocument()

Returns the current instance of PDDocument

Returns:

PDDocument

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<PdfSignatureField>> 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 PdfSignatureFields

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 of a page to get annotation box of

Returns:

AnnotationBox representing page dimensions

getPageRotation

public int getPageRotation(int page)

Description copied from interface: PdfDocumentReader

This method returns a corresponding page's rotation within the document

Specified by:

getPageRotation in interface PdfDocumentReader

Parameters:

page - number of a page to get rotation of

Returns:

rotation degrees

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

checkDocumentPermissions

@Deprecated
public void checkDocumentPermissions()

Deprecated.

Description copied from interface: PdfDocumentReader

This method checks if the document is not encrypted or with limited edition rights

Specified by:

checkDocumentPermissions in interface PdfDocumentReader

isEncrypted

public boolean isEncrypted()

Description copied from interface: PdfDocumentReader

This method checks whether the document is encrypted

Specified by:

isEncrypted in interface PdfDocumentReader

Returns:

TRUE if the document is encrypted, FALSE otherwise

isOpenWithOwnerAccess

public boolean isOpenWithOwnerAccess()

Description copied from interface: PdfDocumentReader

This method verifies if the document has been opened with a full owner access (all modifications are permitted)

Specified by:

isOpenWithOwnerAccess in interface PdfDocumentReader

Returns:

TRUE if the document has been open with a full access, FALSE otherwise

canFillSignatureForm

public boolean canFillSignatureForm()

Description copied from interface: PdfDocumentReader

This method verifies whether fill-in of existing signature fields is allowed by PDF document permissions dictionary

Specified by:

canFillSignatureForm in interface PdfDocumentReader

Returns:

TRUE if fill-in signature forms is permitted, FALSE otherwise

canCreateSignatureField

public boolean canCreateSignatureField()

Description copied from interface: PdfDocumentReader

This method verifies whether creation of new signature fields is allowed by the PDF permissions dictionary

Specified by:

canCreateSignatureField in interface PdfDocumentReader

Returns:

TRUE if the new signature field creation is permitted, FALSE otherwise

getCertificationPermission

public CertificationPermission getCertificationPermission()

Description copied from interface: PdfDocumentReader

Returns value of /DocMDP dictionary defining the permitted modification in a PDF, when present

Specified by:

getCertificationPermission in interface PdfDocumentReader

Returns:

CertificationPermission

isUsageRightsSignaturePresent

public boolean isUsageRightsSignaturePresent()

Description copied from interface: PdfDocumentReader

This method verifies whether a PDF contains a usage rights signature

Specified by:

isUsageRightsSignaturePresent in interface PdfDocumentReader

Returns:

TRUE of a PDF contains a usage rights signature, FALSE otherwise

getCatalogDictionary

public PdfDict getCatalogDictionary()

Description copied from interface: PdfDocumentReader

Returns a document catalog as a dictionary

Specified by:

getCatalogDictionary in interface PdfDocumentReader

Returns:

PdfDict

generateDocumentId

public long generateDocumentId(PAdESCommonParameters parameters)

Computes a DocumentId in a deterministic way based on the given parameters and the document

Parameters:

parameters - PAdESCommonParameters

Returns:

deterministic identifier