How to work with PDF files in Java

The Java JDK has no support for PDF files on its own. This can be added by using a third party native Java PDF library or a Java wrapper on a non-native PDF library. We cover examples of both.

Which one you need depends on the task. Creating documents, workflow processing, editing raw objects, and rendering pages are very different problems, and no single library is the best answer to all problems. Budget, license terms, implementation requirements, file security and support expectations narrow it further.

Java PDF libraries compared

What do you want to do with the PDF file?

All of the libraries below expose a Java PDF API. Find the task, then the tool.

• Create PDF documents. iText or Apache FOP.
• Debug a broken PDF. You need an inspector to view the PDF objects and the document tree. There are several approaches to debugging PDF files, including opening the raw structure in a text editor.
• Edit raw PDF objects. iText.
• Extract, print, or rasterize. Apache PDFBox or JPedal. See our guides to extracting text from PDF files in Java, printing PDF files from Java, and converting PDF to image in Java.
• Merge or parse existing files. See merging PDFs in Java and writing a Java PDF parser.
• Use the Adobe libraries from Java. Datalogics.

What can you do with JPedal?

JPedal is our commercial Java PDF library. It requires Java 17 or later and provides a Java PDF API allowing you to:

• Access and edit form and annotation data
• Add a PDF viewer to Java applications
• Convert PDF documents to images (including HEIC)
• Extract images, text, and metadata
• Inspect a PDF file
• Print PDF files
• Search text

You can also use our extensive PDF Library guide to help you choose the right library for you. Alternatively, if you choose build your solution in-house, our build vs buy guide can help you figure out development timelines and implication for your specific workflows.

FAQ

Does the JDK include a PDF library?

No. javax.print and java.awt.print can send a rendered image to a printer, and javax.imageio handles raster formats, but nothing in the standard library parses PDF syntax or decodes content streams. You need a third-party JAR for any PDF work.

Can I use iText in a closed-source commercial product for free?

No. The free distribution of iText is AGPL v3, which requires you to release the source of any application that uses it, including applications only reached over a network. Shipping closed-source software means buying a commercial license. Apache PDFBox and Apache FOP are Apache 2.0 and carry no such requirement.

Why do two libraries produce different output from the same PDF?

PDF is a description of drawing operations, not a fixed rendering. Differences in font substitution when an embedded font is missing, color space and ICC profile handling, blend mode support, and shading pattern interpolation all produce visibly different pages from identical input. This is why rendering fidelity is worth testing against your own corpus rather than trusting a feature matrix.

//Convenience static method (see class for additional options)
ExtractClippedImages.writeAllClippedImagesToDir("inputFileOrDirectory", "outputDir", "outputImageFormat", new String[] {"imageHeightAsFloat", "subDirectoryForHeight"});

final PdfManipulator pdf = new PdfManipulator();
pdf.loadDocument(new File("inputFile.pdf"));
pdf.addPage(1, PaperSize.A4_LANDSCAPE);
pdf.addText(1, "Hello World", 10, 10, BaseFont.HelveticaBold, 12, 1, 0.3f, 0.2f);
pdf.addImage(1, new BufferedImage(), new float[] {0, 0, 100, 100});
pdf.rotatePage(1, 90);
pdf.apply();
pdf.writeDocument(new File("outputFile.pdf"));

Viewer viewer = new Viewer();
viewer.setupViewer();
viewer.executeCommand(ViewerCommands.OPENFILE, "pdfFile.pdf");

//Convenience static method (see class for additional options)
ExtractTextAsWordList.writeAllWordlistsToDir("inputFileOrDirectory", "outputDir", -1);

PdfMerge.mergeFiles(new File("inputFile1.pdf"), new File("inputFile2.pdf"), new File("outputFile.pdf"));

PdfManipulator.splitInHalf(new File("inputFile.pdf"), new File("outputFolder"), pageToSplitAt);

PrintPdfPages print = new PrintPdfPages("C:/pdfs/mypdf.pdf");

if (print.openPDFFile()) {
    print.printAllPages("Printer Name");
}

//Convenience static method (see class for additional options)
ExtractClippedImages.writeAllClippedImagesToDir("inputFileOrDirectory", "outputDir", "outputImageFormat", new String[] {"imageHeightAsFloat", "subDirectoryForHeight"});

//Convenience static method (see class for additional options)
ArrayList resultsForPages = FindTextInRectangle.findTextOnAllPages("/path/to/file.pdf", "textToFind");

java -jar jpedal.jar --inspect "inputFile.pdf"

PdfSigner.signPdf(
        "inputFile.pdf",
        "outputFile.pdf",
        "keystorePassword",
        "keystoreFile.p12",
        "signerName",
        "signerLocation",
        "signingReason",
        ACCESS_PERMISSION.P1
);