Wie man PDF-Dateien in Java erstellt

Was ist IronPDF for Java und warum sollte man es verwenden?

IronPDF for Java ist eine PDF-Generierungs- und Manipulationsbibliothek, die auf der Chromium-Rendering-Engine basiert. Da es HTML genau so wie Chrome rendert, bewältigt es komplexe Layouts, benutzerdefinierte Schriftarten, CSS-Animationen, von JavaScript generierte Inhalte und eingebettete Bilder ohne manuelle Layouthandhabung.

Die Bibliothek deckt den gesamten PDF-Lebenszyklus in einer einzigen Abhängigkeit ab. Entwickler können Dokumente von Grund auf erstellen, vorhandene HTML-Inhalte konvertieren, Dateien zusammenführen oder teilen, Wasserzeichen hinzufügen, mit Passwörtern verschlüsseln, Text und Bilder extrahieren und ausfüllbare Formulare generieren, alles durch eine konsistente API. Für HTML-intensive Workflows vermeidet IronPDF die manuellen Seitenlayout-Berechnungen, die bei niedrigstufigen PDF-Bibliotheken wie Apache PDFBox erforderlich sind.

Im Gegensatz zu iText, das eine AGPL-Open-Source-Lizenz für die meisten kommerziellen Anwendungen erfordert, bietet IronPDF kommerziell-freundliche Lizenzbedingungen und erfordert keine komplexen Lizenzprüfung. IronPDF for Java wird als Maven-Artefakt geliefert und läuft unter Windows, Linux und macOS. Es integriert sich mit Spring Boot, Jakarta EE und eigenständigen Java-Anwendungen. Die Bibliothek unterstützt auch Server-Bereitstellungen auf AWS, Azure und Google Cloud.

Was sind die Voraussetzungen für die Verwendung von IronPDF in Java?

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/maven-full.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>2024.9.1</version>
</dependency>

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/maven-full.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>2024.9.1</version>
</dependency>

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/gradle-dependency.gradle
implementation 'com.ironsoftware:ironpdf:2024.9.1'

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/imports.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.render.ChromePdfRenderOptions;
import com.ironsoftware.ironpdf.render.PaperOrientation;
import com.ironsoftware.ironpdf.render.PaperSize;
import com.ironsoftware.ironpdf.security.SecurityOptions;
import com.ironsoftware.ironpdf.security.SecurityManager;
import java.io.IOException;
import java.nio.file.Paths;

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/imports.java
import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.render.ChromePdfRenderOptions;
import com.ironsoftware.ironpdf.render.PaperOrientation;
import com.ironsoftware.ironpdf.render.PaperSize;
import com.ironsoftware.ironpdf.security.SecurityOptions;
import com.ironsoftware.ironpdf.security.SecurityManager;
import java.io.IOException;
import java.nio.file.Paths;

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/license-setup.java
License.setLicenseKey("Your-License-Key");

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/license-setup.java
License.setLicenseKey("Your-License-Key");

Wie erzeuge ich ein PDF aus einer HTML-Zeichenfolge in Java?

Übergeben Sie beliebige HTML-Zeichenfolgen direkt an PdfDocument.renderHtmlAsPdf(). IronPDF gibt eine PdfDocument-Instanz zurück, die das fertige Dokument im Speicher repräsentiert. Rufen Sie saveAs() auf, um es auf die Festplatte zu schreiben.

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/html-string-to-pdf.java
// HTML content with inline CSS
String htmlContent = "<h1>Hello World!</h1><p>This is an example HTML string.</p>";

// Render HTML string to PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(htmlContent);

// Save to disk
pdf.saveAs(Paths.get("html.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/html-string-to-pdf.java
// HTML content with inline CSS
String htmlContent = "<h1>Hello World!</h1><p>This is an example HTML string.</p>";

// Render HTML string to PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(htmlContent);

// Save to disk
pdf.saveAs(Paths.get("html.pdf"));

renderHtmlAsPdf() unterstützt die vollständigen HTML5- und CSS3-Spezifikationen, einschließlich Webfonts, Flexbox, Grid-Layouts und JavaScript-Ausführung. Das folgende Beispiel verwendet eine mehrzeilige HTML-Vorlage mit benutzerdefinierten Stilen:

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/html-string-styled.java
// Multi-line HTML with CSS styling using a text block (Java 13+)
String styledHtml = """
    <!DOCTYPE html>
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; margin: 40px; }
            h1 { color: #2563eb; border-bottom: 2px solid #e5e7eb; padding-bottom: 8px; }
            .summary { background: #f3f4f6; padding: 16px; border-radius: 4px; }
        </style>
    </head>
    <body>
        <h1>Invoice #1042</h1>
        <div class="summary">
            <p>Amount due: $1,250.00</p>
            <p>Due date: 2024-06-01</p>
        </div>
    </body>
    </html>
    """;

PdfDocument invoice = PdfDocument.renderHtmlAsPdf(styledHtml);
invoice.saveAs(Paths.get("invoice.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/html-string-styled.java
// Multi-line HTML with CSS styling using a text block (Java 13+)
String styledHtml = """
    <!DOCTYPE html>
    <html>
    <head>
        <style>
            body { font-family: Arial, sans-serif; margin: 40px; }
            h1 { color: #2563eb; border-bottom: 2px solid #e5e7eb; padding-bottom: 8px; }
            .summary { background: #f3f4f6; padding: 16px; border-radius: 4px; }
        </style>
    </head>
    <body>
        <h1>Invoice #1042</h1>
        <div class="summary">
            <p>Amount due: $1,250.00</p>
            <p>Due date: 2024-06-01</p>
        </div>
    </body>
    </html>
    """;

PdfDocument invoice = PdfDocument.renderHtmlAsPdf(styledHtml);
invoice.saveAs(Paths.get("invoice.pdf"));

Das obige Rechnungsexemplar verwendet Java Textblöcke (seit Java 13 verfügbar) für sauberere mehrzeilige HTML. Bei älteren Java-Versionen fügen Sie die HTML-Zeichenkette manuell zusammen oder laden Sie sie mithilfe von renderHtmlFileAsPdf() aus einer Datei. Für einen umfassenderen Blick auf die HTML-zu-PDF-Konvertierung einschließlich JavaScript-Rendering, siehe das HTML zu PDF-Tutorial for Java.

Wie erzeuge ich ein PDF aus einer lokalen HTML-Datei in Java?

Verwenden Sie PdfDocument.renderHtmlFileAsPdf(), um eine auf dem lokalen Dateisystem gespeicherte HTML-Datei zu konvertieren. Übergeben Sie den Pfad als Zeichenfolge; relative Pfade werden relativ zum aktuellen Arbeitsverzeichnis aufgelöst:

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/html-file-to-pdf.java
// Convert a local HTML file to PDF
PdfDocument filePdf = PdfDocument.renderHtmlFileAsPdf("invoice-template.html");

// Save the converted document
filePdf.saveAs(Paths.get("invoice_output.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/html-file-to-pdf.java
// Convert a local HTML file to PDF
PdfDocument filePdf = PdfDocument.renderHtmlFileAsPdf("invoice-template.html");

// Save the converted document
filePdf.saveAs(Paths.get("invoice_output.pdf"));

IronPDF löst alle referenzierten Ressourcen (externe CSS-Dateien, lokale Bilder und JavaScript-Bibliotheken) relativ zum Verzeichnis der HTML-Datei auf. Das bedeutet, dass Sie eine vollständige HTML-Vorlage mit verlinkten Stylesheets erstellen und durch IronPDF ohne Anpassung der Asset-Pfade ausführen können.

Die Methode akzeptiert sowohl einen String-Pfad als auch ein java.nio.file.Path-Objekt. Für den Produktivbetrieb bevorzugen Sie absolute Pfade, um Mehrdeutigkeiten des Arbeitsverzeichnisses zu vermeiden. Siehe das HTML-Datei zu PDF Beispiel für eine vollständige funktionierende Demonstration.

Wie erzeuge ich ein PDF aus einer Webseitens-URL in Java?

PdfDocument.renderUrlAsPdf() ruft eine Live-URL ab, rendert sie mit Chromium und gibt ein PDF zurück. Dies ist nützlich zur Erfassung von Dashboard-Schnappschüssen, Generierung von PDF-Quittungen von gehosteten Quittungsseiten oder Archivierung von Webinhalten:

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/url-to-pdf.java
// Render a live web page to PDF
PdfDocument webPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");
webPdf.saveAs(Paths.get("ironpdf-homepage.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/url-to-pdf.java
// Render a live web page to PDF
PdfDocument webPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");
webPdf.saveAs(Paths.get("ironpdf-homepage.pdf"));

Für Seiten hinter HTTP-Authentifizierung übermitteln Sie die Anmeldedaten über ChromePdfRenderOptions:

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/url-to-pdf-auth.java
// Configure render options with login credentials
ChromePdfRenderOptions renderOptions = new ChromePdfRenderOptions();
renderOptions.setAuthUsername("username");
renderOptions.setAuthPassword("password");

// Render authenticated page to PDF
PdfDocument securedPdf = PdfDocument.renderUrlAsPdf("https://your-internal-app.com/report", renderOptions);
securedPdf.saveAs(Paths.get("internal-report.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/url-to-pdf-auth.java
// Configure render options with login credentials
ChromePdfRenderOptions renderOptions = new ChromePdfRenderOptions();
renderOptions.setAuthUsername("username");
renderOptions.setAuthPassword("password");

// Render authenticated page to PDF
PdfDocument securedPdf = PdfDocument.renderUrlAsPdf("https://your-internal-app.com/report", renderOptions);
securedPdf.saveAs(Paths.get("internal-report.pdf"));

Siehe das URL zu PDF Code-Beispiel für Details. Für komplexere Anmeldevorgänge mit Cookies oder Formularbasierter Authentifizierung, siehe Website-Login-Handhabung.

Wie kontrolliere ich Seitengröße, Ausrichtung und Ränder?

Verwenden Sie ChromePdfRenderOptions, um das Layout der Ausgabe-PDF-Datei anzupassen. Übergeben Sie die konfigurierten Optionen als zweites Argument an jede Render-Methode. Die häufigsten Einstellungen sind Seitenausrichtung, Papiergröße und Ränder:

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/pdf-formatting.java
ChromePdfRenderOptions renderOptions = new ChromePdfRenderOptions();

// Set landscape orientation (default is portrait)
renderOptions.setPaperOrientation(PaperOrientation.LANDSCAPE);

// Use US Letter paper size (default is A4)
renderOptions.setPaperSize(PaperSize.LETTER);

// Set margins in millimeters (top, right, bottom, left)
renderOptions.setMarginTop(15);
renderOptions.setMarginRight(15);
renderOptions.setMarginBottom(15);
renderOptions.setMarginLeft(15);

// Include background colors and images
renderOptions.setPrintHtmlBackgrounds(true);

// Apply options when rendering
PdfDocument report = PdfDocument.renderHtmlAsPdf("<h1>Quarterly Report</h1>", renderOptions);
report.saveAs(Paths.get("report.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/pdf-formatting.java
ChromePdfRenderOptions renderOptions = new ChromePdfRenderOptions();

// Set landscape orientation (default is portrait)
renderOptions.setPaperOrientation(PaperOrientation.LANDSCAPE);

// Use US Letter paper size (default is A4)
renderOptions.setPaperSize(PaperSize.LETTER);

// Set margins in millimeters (top, right, bottom, left)
renderOptions.setMarginTop(15);
renderOptions.setMarginRight(15);
renderOptions.setMarginBottom(15);
renderOptions.setMarginLeft(15);

// Include background colors and images
renderOptions.setPrintHtmlBackgrounds(true);

// Apply options when rendering
PdfDocument report = PdfDocument.renderHtmlAsPdf("<h1>Quarterly Report</h1>", renderOptions);
report.saveAs(Paths.get("report.pdf"));

ChromePdfRenderOptions bietet über 30 Einstellungen, die über die oben gezeigten hinausgehen, darunter DPI, JavaScript-Ausführungszeitlimit, Zoomfaktor und CSS-Medientyp. Eine vollständige Liste finden Sie unter den Einstellungen zur PDF-Erstellung. Für benutzerdefinierte Papierformate, die nicht in der Enumeration PaperSize enthalten sind, siehe benutzerdefinierte PDF-Papierformate.

Wie füge ich einen Passwortschutz zu einem PDF in Java hinzu?

SecurityOptions steuert Lese- und Eigentümerpasswörter sowie Berechtigungsflags. Übergeben Sie SecurityOptions an das SecurityManager des Dokuments, bevor Sie speichern:

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/password-protect-basic.java
// Create security settings with a user-facing password
SecurityOptions securityOptions = new SecurityOptions();
securityOptions.setUserPassword("shareable");

// Apply security to the document
PdfDocument urlPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");
SecurityManager securityManager = urlPdf.getSecurity();
securityManager.setSecurityOptions(securityOptions);

// Save the password-protected document
urlPdf.saveAs(Paths.get("protected.pdf"));

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/password-protect-basic.java
// Create security settings with a user-facing password
SecurityOptions securityOptions = new SecurityOptions();
securityOptions.setUserPassword("shareable");

// Apply security to the document
PdfDocument urlPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");
SecurityManager securityManager = urlPdf.getSecurity();
securityManager.setSecurityOptions(securityOptions);

// Save the password-protected document
urlPdf.saveAs(Paths.get("protected.pdf"));

Für strengere Kontrolle setzen Sie ein Besitzerpasswort und beschränken Sie bestimmte Operationen:

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/password-protect-advanced.java
SecurityOptions advancedSecurity = new SecurityOptions();

// User password: required to open the file
advancedSecurity.setUserPassword("user-open-pass");

// Owner password: required to change security settings
advancedSecurity.setOwnerPassword("owner-admin-pass");

// Restrict editing operations
advancedSecurity.setAllowPrint(false);
advancedSecurity.setAllowCopy(false);
advancedSecurity.setAllowEditContent(false);
advancedSecurity.setAllowEditAnnotations(false);

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/password-protect-advanced.java
SecurityOptions advancedSecurity = new SecurityOptions();

// User password: required to open the file
advancedSecurity.setUserPassword("user-open-pass");

// Owner password: required to change security settings
advancedSecurity.setOwnerPassword("owner-admin-pass");

// Restrict editing operations
advancedSecurity.setAllowPrint(false);
advancedSecurity.setAllowCopy(false);
advancedSecurity.setAllowEditContent(false);
advancedSecurity.setAllowEditAnnotations(false);

Das Öffnen des PDF fordert den Leser zur Eingabe eines Passworts auf:

PDF-Reader zeigen eine Passwortaufforderung an, wenn das Dokument mit einem Benutzerpasswort geschützt ist.

Nach Eingabe des korrekten Passworts öffnet sich das PDF und zeigt den vollständigen Inhalt an:

Das Dokument rendert normal, nachdem das richtige Passwort eingegeben wurde.

Siehe Sicherheits- und Metadaten-Einstellungen für die vollständige Liste der Berechtigungsflaggen.

Wie erzeugt man PDFs in einer Spring Boot-Anwendung?

IronPDF integriert sich direkt mit Spring Boot. Geben Sie ein PDF als Byte-Array-HTTP-Antwort von jeder Controllermethode zurück; dieses Muster funktioniert für bedarfsgesteuerte Berichtsgenerierung, Rechnungsdownloads und Datenexporte.

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/spring-boot-controller.java
import com.ironsoftware.ironpdf.*;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.io.IOException;

@RestController
@RequestMapping("/api/pdf")
public class PdfController {

    @GetMapping("/invoice/{id}")
    public ResponseEntity<byte[]> generateInvoice(@PathVariable String id) throws IOException {
        // Build HTML dynamically using the invoice ID
        String html = """
            <html><body>
              <h1>Invoice #%s</h1>
              <p>Amount due: $500.00</p>
            </body></html>
            """.formatted(id);

        // Render and return as PDF download
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);
        byte[] pdfBytes = pdf.getBinaryData();

        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_PDF);
        headers.setContentDispositionFormData("attachment", "invoice-" + id + ".pdf");

        return ResponseEntity.ok().headers(headers).body(pdfBytes);
    }
}

//:path=/static-assets/pdf/content-code-examples/how-to/java-create-pdf-tutorial/spring-boot-controller.java
import com.ironsoftware.ironpdf.*;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;
import java.io.IOException;

@RestController
@RequestMapping("/api/pdf")
public class PdfController {

    @GetMapping("/invoice/{id}")
    public ResponseEntity<byte[]> generateInvoice(@PathVariable String id) throws IOException {
        // Build HTML dynamically using the invoice ID
        String html = """
            <html><body>
              <h1>Invoice #%s</h1>
              <p>Amount due: $500.00</p>
            </body></html>
            """.formatted(id);

        // Render and return as PDF download
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);
        byte[] pdfBytes = pdf.getBinaryData();

        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_PDF);
        headers.setContentDispositionFormData("attachment", "invoice-" + id + ".pdf");

        return ResponseEntity.ok().headers(headers).body(pdfBytes);
    }
}

Die Methode getBinaryData() gibt das PDF als Byte-Array zurück, das Spring Boot direkt an den Client überträgt. Es wird keine temporäre Datei auf die Festplatte geschrieben. Für Bereitstellungen mit hohem Durchsatz sollten Sie License.setLicenseKey() in einer @PostConstruct-Methode oder einem Anwendungsstart-Listener instanziieren, anstatt dies pro Anfrage zu tun.

Was sind die nächsten Schritte für die Java PDF-Erstellung?

Dieser Leitfaden demonstrierte vier Ansätze zur PDF-Generierung in Java mit IronPDF: HTML-Zeichenfolgen-Rendering, lokale Dateikonvertierung, URL-Erfassung und Spring Boot HTTP-Antwort-Streaming. Alle Methoden nutzen dieselbe PdfDocument-API, ChromePdfRenderOptions zur Formatierungssteuerung und SecurityOptions zum Zugriffsschutz.

IronPDF for Java unterstützt auch das Hinzufügen und Stempeln von Wasserzeichen, das Zusammenführen mehrerer PDF-Dateien, das Teilen von PDFs in einzelne Seiten, das Hinzufügen digitaler Signaturen, das Rendern von JavaScript-Diagrammen zu PDF und das programmgesteuerte Drucken von PDFs.

Starten Sie eine kostenlose Testversion, um PDFs ohne Wasserzeichen zu generieren, oder sehen Sie sich Lizenzierungsoptionen an, um einen Plan zu wählen, der zu Ihrem Projekt passt. Bereit, tiefer einzutauchen? Schauen Sie sich die vollständige IronPDF for Java-Tutorial-Seite an.