Interface PdfAcroFormService

All Known Implementing Classes:

PdfAcroFormServiceImpl

public interface PdfAcroFormService

Method Summary

Modifier and Type	Method	Description
void	fillAcroForm(File pdfFile, Map<String,String> fieldValues)	Reads a pdf containing a AcroForm from the given input stream, sets all field values and returns the resulting PDF in the given OutputStream Fields are handled as follows: - if null is passed as value, the field is skipped - if the field is a PDCheckbox, the value is parsed as boolean, pass "true" to check it - if the field is a PDRadiobutton, the value is parsed as int (the index of the option to be selected) - else the string value is set as is
void	findAcroFieldnames(File pdfFile)	This is a helper function that can be used to find the FullyQualified field names of an AcroForm - logs all fieldnames with some type information - prints the fieldname of all textfields into the field itself This method should probably not be used in production code, but it is very handy when implementing an automatic AcroForm field mapping
void	overlayImage(File pdfFile, String fieldname, byte[] image)	Overlays an image over a PDF AcroForm Field The image is scaled as follows: - If the image is wider than the form field, the image is scaled down to the width of the field - If the shrinked image is higher than the form field, it is centered vertically over the form field and might overlap
void	removePage(File pdfFile, int pageNumber)	Removes a page from a pdf document

Method Details

fillAcroForm

void fillAcroForm(File pdfFile,
 Map<String,String> fieldValues)
           throws IOException

Reads a pdf containing a AcroForm from the given input stream, sets all field values and returns the resulting PDF in the given OutputStream Fields are handled as follows: - if null is passed as value, the field is skipped - if the field is a PDCheckbox, the value is parsed as boolean, pass "true" to check it - if the field is a PDRadiobutton, the value is parsed as int (the index of the option to be selected) - else the string value is set as is

Parameters:

pdfFile - The file used to read the pdf and to save the result

fieldValues - a map of all field values to be replaced, use the FullyQualifiedName as key

Throws:

IllegalArgumentException - is thrown when the pdf does not contain a AcroForm or a field was not found

IOException

removePage

void removePage(File pdfFile,
 int pageNumber)
         throws IOException

Removes a page from a pdf document

Parameters:

pdfFile - The file used to read the pdf and to save the result

pageNumber - 0 based index of page to remove

Throws:

IOException

overlayImage

void overlayImage(File pdfFile,
 String fieldname,
 byte[] image)
           throws IOException

Overlays an image over a PDF AcroForm Field The image is scaled as follows: - If the image is wider than the form field, the image is scaled down to the width of the field - If the shrinked image is higher than the form field, it is centered vertically over the form field and might overlap

Parameters:

pdfFile - The file used to read the pdf and to save the result

fieldname - Fully qualified name of field where the image should be placed

image - The image (byte array)

Throws:

IllegalArgumentException - is thrown when the pdf does not contain a AcroForm or a field was not found

IOException

findAcroFieldnames

void findAcroFieldnames(File pdfFile)
                 throws IOException

This is a helper function that can be used to find the FullyQualified field names of an AcroForm - logs all fieldnames with some type information - prints the fieldname of all textfields into the field itself This method should probably not be used in production code, but it is very handy when implementing an automatic AcroForm field mapping

Parameters:

pdfFile - The file used to read the pdf and to save the result

Throws:

IllegalArgumentException - is thrown when the pdf does not contain a AcroForm

IOException