PDFs in Java erzeugen mit Apache PDFBox

Die Erzeugung von PDF-Dateien ist eine häufige Anforderung in vielen Anwendungen, sei es für die Erstellung von Berichten, Rechnungen, Dokumentationen oder anderen Dokumenten. Eine der populärsten Bibliotheken zur Handhabung von PDF-Dateien in Java ist Apache PDFBox. Diese leistungsstarke Open-Source-Bibliothek bietet umfangreiche Funktionen zum Erstellen, Bearbeiten und Lesen von PDF-Dateien. In diesem Artikel wird detailliert beschrieben, wie man mit Apache PDFBox PDF-Dateien in Java erzeugen kann.

Einführung in Apache PDFBox

Apache PDFBox ist ein Open-Source-Java-Werkzeug zum Arbeiten mit PDF-Dokumenten. Es ermöglicht Entwicklern, PDF-Dokumente zu erstellen, zu manipulieren und zu extrahieren. Die Bibliothek ist flexibel und bietet eine breite Palette von Funktionen, einschließlich der Möglichkeit, Text, Bilder und Grafiken in PDF-Dateien einzufügen, Formulare zu bearbeiten und Metadaten zu verwalten.

Installation von Apache PDFBox

Bevor wir mit der Arbeit beginnen können, müssen wir Apache PDFBox in unser Java-Projekt integrieren. Dies kann entweder manuell durch das Herunterladen der JAR-Dateien von der offiziellen Apache PDFBox-Website oder durch die Verwendung eines Build-Management-Tools wie Maven oder Gradle erfolgen.

Hier ist ein Beispiel für die Einbindung von Apache PDFBox in ein Maven-Projekt:

<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>pdfbox</artifactId>
    <version>2.0.24</version>
</dependency>Code-Sprache: HTML, XML (xml)

Erste Schritte mit Apache PDFBox

Nach der Installation können wir beginnen, PDF-Dokumente zu erstellen. Hier ist ein einfaches Beispiel, das zeigt, wie man ein neues PDF-Dokument erstellt und Text hinzufügt:

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;
import org.apache.pdfbox.pdmodel.font.PDType1Font;

import java.io.IOException;

public class PDFBoxExample {
    public static void main(String[] args) {
        // Neues Dokument erstellen
        try (PDDocument document = new PDDocument()) {
            // Neue Seite erstellen
            PDPage page = new PDPage();
            document.addPage(page);

            // Content Stream für das Schreiben in die Seite erstellen
            try (PDPageContentStream contentStream = new PDPageContentStream(document, page)) {
                // Schriftart und Textposition festlegen
                contentStream.beginText();
                contentStream.setFont(PDType1Font.HELVETICA_BOLD, 12);
                contentStream.newLineAtOffset(100, 700);
                contentStream.showText("Hallo, Welt!");
                contentStream.endText();
            }

            // Dokument speichern
            document.save("example.pdf");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}Code-Sprache: JavaScript (javascript)

In diesem Beispiel erstellen wir ein neues PDF-Dokument, fügen eine Seite hinzu, erstellen einen Content-Stream und schreiben den Text „Hallo, Welt!“ auf die Seite. Schließlich speichern wir das Dokument als „example.pdf“.

Hinzufügen von Bildern zu einem PDF

PDF-Dokumente bestehen nicht nur aus Text. Oftmals ist es notwendig, Bilder in ein PDF-Dokument einzufügen. Apache PDFBox unterstützt verschiedene Bildformate wie JPEG und PNG. Hier ist ein Beispiel, wie man ein Bild in ein PDF-Dokument einfügt:

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;
import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject;

import java.io.File;
import java.io.IOException;

public class PDFBoxImageExample {
    public static void main(String[] args) {
        try (PDDocument document = new PDDocument()) {
            PDPage page = new PDPage();
            document.addPage(page);

            // Bild laden
            PDImageXObject pdImage = PDImageXObject.createFromFile("path/to/image.jpg", document);

            // Content Stream erstellen und Bild hinzufügen
            try (PDPageContentStream contentStream = new PDPageContentStream(document, page)) {
                contentStream.drawImage(pdImage, 100, 500);
            }

            document.save("image_example.pdf");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}Code-Sprache: JavaScript (javascript)

In diesem Beispiel laden wir ein Bild von der Festplatte und fügen es dem PDF-Dokument hinzu.

Hinzufügen von Formen und Grafiken

Neben Text und Bildern ermöglicht PDFBox auch das Zeichnen von geometrischen Formen und Grafiken. Hier ist ein Beispiel, das zeigt, wie man eine einfache Grafik in ein PDF-Dokument einfügt:

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;

import java.io.IOException;

public class PDFBoxGraphicsExample {
    public static void main(String[] args) {
        try (PDDocument document = new PDDocument()) {
            PDPage page = new PDPage();
            document.addPage(page);

            // Content Stream erstellen
            try (PDPageContentStream contentStream = new PDPageContentStream(document, page)) {
                // Rechteck zeichnen
                contentStream.addRect(100, 600, 200, 100);
                contentStream.stroke();
            }

            document.save("graphics_example.pdf");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}Code-Sprache: JavaScript (javascript)

In diesem Beispiel zeichnen wir ein einfaches Rechteck auf die PDF-Seite.

Bearbeiten von bestehenden PDF-Dokumenten

PDFBox ermöglicht nicht nur das Erstellen neuer PDF-Dokumente, sondern auch das Bearbeiten von bestehenden Dokumenten. Hier ist ein Beispiel, wie man Text zu einem bestehenden PDF-Dokument hinzufügt:

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;
import org.apache.pdfbox.pdmodel.font.PDType1Font;

import java.io.File;
import java.io.IOException;

public class PDFBoxEditExample {
    public static void main(String[] args) {
        try {
            // Bestehendes Dokument laden
            PDDocument document = PDDocument.load(new File("existing_document.pdf"));
            PDPage page = document.getPage(0);

            // Content Stream erstellen und Text hinzufügen
            try (PDPageContentStream contentStream = new PDPageContentStream(document, page, PDPageContentStream.AppendMode.APPEND, true, true)) {
                contentStream.beginText();
                contentStream.setFont(PDType1Font.HELVETICA_BOLD, 12);
                contentStream.newLineAtOffset(100, 700);
                contentStream.showText("Zusätzlicher Text");
                contentStream.endText();
            }

            document.save("edited_document.pdf");
            document.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}Code-Sprache: JavaScript (javascript)

In diesem Beispiel laden wir ein bestehendes PDF-Dokument, fügen Text zu einer Seite hinzu und speichern die Änderungen.

Umgang mit Formularen

PDFBox unterstützt auch das Arbeiten mit PDF-Formularen. Hier ist ein Beispiel, wie man ein einfaches PDF-Formular erstellt und ausfüllt:

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.interactive.form.PDAcroForm;
import org.apache.pdfbox.pdmodel.interactive.form.PDField;
import org.apache.pdfbox.pdmodel.interactive.form.PDTextField;
import org.apache.pdfbox.pdmodel.PDPage;

import java.io.IOException;

public class PDFBoxFormExample {
    public static void main(String[] args) {
        try (PDDocument document = new PDDocument()) {
            PDPage page = new PDPage();
            document.addPage(page);

            // Formular erstellen
            PDAcroForm acroForm = new PDAcroForm(document);
            document.getDocumentCatalog().setAcroForm(acroForm);

            // Textfeld hinzufügen
            PDTextField textBox = new PDTextField(acroForm);
            textBox.setPartialName("TextField");
            acroForm.getFields().add(textBox);

            // Feldposition und -größe festlegen
            try (PDPageContentStream contentStream = new PDPageContentStream(document, page)) {
                contentStream.beginText();
                contentStream.newLineAtOffset(100, 700);
                contentStream.endText();
                textBox.setValue("Beispieltext");
            }

            document.save("form_example.pdf");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}Code-Sprache: JavaScript (javascript)

In diesem Beispiel erstellen wir ein einfaches PDF-Formular mit einem Textfeld und setzen einen Beispieltext.

Fazit

Apache PDFBox ist ein mächtiges Werkzeug für die Arbeit mit PDF-Dokumenten in Java. Es bietet eine breite Palette von Funktionen zum Erstellen, Bearbeiten und Lesen von PDF-Dateien. Durch die Beispiele in diesem Artikel haben wir die grundlegenden Techniken zur Erzeugung und Manipulation von PDF-Dokumenten kennengelernt. Mit diesen Kenntnissen können Entwickler komplexe und dynamische PDF-Dokumente für eine Vielzahl von Anwendungen erstellen.