HTML zu PDF in Java

Wie Füge Ich IronPDF Zu Einem Maven-Projekt In Java Hinzu?

Das Hinzufügen von IronPDF zu einem Maven-Projekt erfordert zwei Einträge im pom.xml Abhängigkeitsblock des Projekts. Der erste zieht die IronPDF-Bibliothek ein; Der zweite fügt einen SLF4J-Logging-Provider hinzu, sodass IronPDF während der Ausführung Nachrichten schreiben kann.

//:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/maven-dependency.xml
<dependency>
  <groupId>com.ironsoftware</groupId>
  <artifactId>ironpdf</artifactId>
  <version>2024.9.1</version>
</dependency>
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-simple</artifactId>
  <version>2.0.5</version>
</dependency>

//:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/maven-dependency.xml
<dependency>
  <groupId>com.ironsoftware</groupId>
  <artifactId>ironpdf</artifactId>
  <version>2024.9.1</version>
</dependency>
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-simple</artifactId>
  <version>2.0.5</version>
</dependency>

Das ironpdf Artefakt verweist auf das neueste IronPDF for Java Release und Änderungsprotokoll. Die slf4j-simple Abhängigkeit bietet ein grundlegendes Logging-Backend. Sie können ihn durch Logback oder Log4J nach Bedarf ersetzen oder ihn ganz weglassen, um die Protokollausgabe zu unterdrücken.

Nachdem Sie beide Einträge hinzugefügt haben, führen Sie mvn install vom Projektstamm aus, um die Artefakte herunterzuladen. Maven löst die Abhängigkeit gegen Maven Central auf.

Wie Installiere Ich Das IronPDF JAR Manuell in Java?

Projekte, die Maven oder einen anderen Abhängigkeitsmanager nicht verwenden, können IronPDF hinzufügen, indem sie das JAR direkt herunterladen und im Klassenpfad einschließen. Navigieren Sie zur IronPDF for Java Herunterladen-Seite und laden Sie die fat-JAR-Datei herunter.

Das fat-JAR bündelt alle Abhängigkeiten, sodass keine zusätzlichen Klassenpfadeinträge über das Hauptartefakt hinaus erforderlich sind. Laden Sie optional ein SLF4J Implementierungs-JAR herunter, um das Logging zu aktivieren.

Fügen Sie beide JARs mit dem Verwaltungspanel Ihrer IDE zur Klassenpfad des Projekts hinzu oder geben Sie -classpath Einträge an, wenn Sie vom Terminal aus kompilieren und ausführen.

Wie Importiere Ich IronPDF in Meine Java-Quell-Dateien?

Das com.ironsoftware.ironpdf Paket enthält alle Konvertierungs- und Verarbeitungskomponenten. Platzieren Sie die folgende Importanweisung am Anfang jeder Java-Datei, die IronPDF-Methoden aufruft.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/import-statement.java

// Import all IronPDF components
import com.ironsoftware.ironpdf.*;

Ein gezielter Import, der spezifische Klassen benennt, ist ebenfalls zulässig: import com.ironsoftware.ironpdf.PdfDocument;. Der Wildcard-Import ist während der Erkundung praktisch.

Wie Setze Ich Einen Lizenzschlüssel in IronPDF for Java?

IronPDF for Java ist ohne Lizenzschlüssel kostenlos nutzbar, es fügt jedoch ein gekacheltes Wasserzeichen zu allen erstellten oder geänderten PDF-Dokumenten hinzu. Um das Wasserzeichen zu entfernen, geben Sie vor dem Aufruf irgendeiner Konvertierungs- oder Manipulationsmethode einen gültigen Lizenzschlüssel an.

//:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/set-license-key.java
// Set the license key before any PDF operations
License.setLicenseKey("YOUR-LICENSE-KEY");

//:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/set-license-key.java
// Set the license key before any PDF operations
License.setLicenseKey("YOUR-LICENSE-KEY");

Platzieren Sie den setLicenseKey Aufruf beim Anwendungsstart, bevor eine PdfDocument Methode aufgerufen wird. Kaufen Sie einen Lizenzschlüssel oder starten Sie eine kostenlose Testversion, um PDFs ohne Wasserzeichen zu erstellen.

Ein gültiger Lizenzschlüssel entfernt das gekachelte Wasserzeichen aus generierten PDFs. Erhalten Sie einen auf der IronPDF-Lizenzierungsseite oder beantragen Sie eine kostenlose Testversion.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/set-log-path.java

import java.nio.file.Paths;
// Redirect log output before using IronPDF
Settings.setLogPath(Paths.get("logs/ironpdf-engine.log"));

Wie Wandle Ich Einen HTML-String In Ein PDF In Java Um?

PdfDocument.renderHtmlAsPdf(String html) konvertiert gültiges HTML-Markup in ein PDF-Dokument. Die Methode akzeptiert einen rohen HTML-String und gibt ein PdfDocument Objekt zurück, das gespeichert, zusammengeführt oder weiter modifiziert werden kann.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/html-string-to-pdf.java

// Convert a minimal HTML string to a PDF document
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
// Save the resulting document to disk
pdf.saveAs("html-string-output.pdf");

IronPDF rendert HTML-Markup direkt in ein pixelgenaues PDF. Der hier gezeigte Output wurde durch das obige Codebeispiel erstellt.

Die Rendering-Engine basiert auf Chromium, sodass jedes HTML, CSS oder JavaScript, das in Chrome funktioniert, im PDF korrekt gerendert wird. Dies schließt Flexbox-Layouts, CSS Grid, Web-Schriften, SVGs und JavaScript-gesteuerte Diagramme ein.

Eine überladene Version der Methode akzeptiert ein zweites Argument für einen Basispfad: renderHtmlAsPdf(String html, String basePath). Dieser Basis-Pfad wird verwendet, um relative Verweise auf lokale Stylesheets, Bilder und Skripte aufzulösen.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/html-string-with-assets.java

// HTML referencing local stylesheet and image
String html = "<html><head><link rel='stylesheet' href='style.css'></head>"
    + "<body><img src='logo.png'/><h1>Invoice</h1></body></html>";
// Provide the folder containing style.css and logo.png as the base path
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html, "C:/invoices/");
pdf.saveAs("invoice-output.pdf");

Der Basis-Pfad kann auf ein Verzeichnis im lokalen Dateisystem oder auf eine entfernte URL zeigen. IronPDF ruft referenzierte Assets während des Renderings von diesem Speicherort ab.

Wenn ein Basis-Pfad angegeben ist, löst IronPDF lokale CSS- und Bildverweise auf, um ein vollständig gestyltes PDF zu erzeugen.

Für einen fokussierten Blick auf diese Methode, siehe das HTML-String Zu PDF-Codebeispiel.

Wie Wandle Ich Eine URL In Ein PDF In Java Um?

PdfDocument.renderUrlAsPdf(String url) ruft die Seite an der angegebenen URL ab und rendert das vollständige DOM (einschließlich JavaScript-Ausführung), bevor es die Ausgabe als PDF speichert.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/url-to-pdf.java

// Render a live web page to PDF by URL
PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
// Save the rendered document
pdf.saveAs("wikipedia-pdf-article.pdf");

IronPDF erfasst den vollständigen gerenderten Zustand einer Webseite, einschließlich dynamischer Inhalte, die durch JavaScript erstellt werden.

Die Chromium-Rendering-Engine ruft externe Stylesheets, Schriften und JavaScript-Dateien ab, sodass das resultierende PDF den visuellen Zustand der Seite genau widerspiegelt. Diese Methode eignet sich gut für die Berichtserstellung aus Web-Dashboards, das Archivieren öffentlicher Webinhalte oder das Konvertieren von Datenvisualisierungen, die von Client-seitigem Rendering abhängen.

Siehe das Beispiel für die URL-zu-PDF-Konvertierung für zusätzliche Optionen wie benutzerdefinierte Anforderungsheader und Authentifizierung.

Wie Wandle Ich Eine HTML-Datei In Ein PDF In Java Um?

PdfDocument.renderHtmlFileAsPdf(String filePath) liest eine HTML-Datei aus dem lokalen Dateisystem und konvertiert sie in ein PDF. Die Methode löst automatisch alle relativen Asset-Verweise in der HTML-Datei gegen das Verzeichnis der Datei auf.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/html-file-to-pdf.java

// Convert a local HTML file (with a linked CSS file) to PDF
PdfDocument pdf = PdfDocument.renderHtmlFileAsPdf("C:/invoices/TestInvoice1.html");
// Save the resulting document
pdf.saveAs("invoice-from-file.pdf");

Die Methode behandelt HTML-Projekte mit mehreren Dateien korrekt. Im obigen Beispiel, wenn TestInvoice1.html auf ein Stylesheet im selben Verzeichnis verweist, wendet IronPDF dieses Stylesheet während des Renderings an. Das Ergebnis ist ein PDF, das dem browsergerenderten Erscheinungsbild der Quelldatei entspricht.

Diese Methode ist besonders nützlich für PDF-Erstellung-Workflows, die HTML-Vorlagen auf der Festplatte pflegen: Rechnungsgeneratoren, Berichtsvorlagen und Formularausgabesysteme sind gängige Anwendungsfälle.

Wie Setze Ich Seitenformat Und Ausrichtung Für PDF In Java?

Seitengröße und Orientierung werden über die ChromePdfRenderOptions Klasse gesteuert. Erstellen Sie eine ChromePdfRenderOptions Instanz, konfigurieren Sie die Eigenschaften und übergeben Sie sie als zweites Argument an jeden renderHtmlAsPdf Aufruf.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/page-size-orientation.java

import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.render.*;
// Create rendering options for the PDF
ChromePdfRenderOptions options = new ChromePdfRenderOptions();
// Set paper size to A4
options.setPaperSize(PaperSize.A4);
// Set to landscape orientation
options.setPaperOrientation(PaperOrientation.Landscape);
// Apply options to the conversion
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Landscape Report</h1>", options);
pdf.saveAs("landscape-a4-report.pdf");

PaperSize umfasst Standardoptionen wie A4, Letter, Legal, A3 und A5. PaperOrientation akzeptiert Portrait (Standard) oder Landscape.

Für nicht standardisierte Abmessungen verwenden Sie setCustomPaperSizeInMillimeters(double width, double height) oder setCustomPaperSizeInInches(double width, double height):

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/custom-paper-size.java

ChromePdfRenderOptions options = new ChromePdfRenderOptions();
// Set a custom 100mm x 150mm page size
options.setCustomPaperSizeInMillimeters(100, 150);
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<p>Custom size card</p>", options);
pdf.saveAs("custom-size-card.pdf");

Siehe das Beispiel für benutzerdefinierte PDF-Papiergrößen für die vollständige Liste der PaperSize Konstanten und Größenoptionen.

Wie Setze Ich Benutzerdefinierte Ränder Bei Einem PDF In Java?

Randgrößen werden ebenfalls über ChromePdfRenderOptions festgelegt. Die Bibliothek stellt separate Setter für obere, untere, linke und rechte Ränder bereit, die alle Werte in Millimetern akzeptieren.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/custom-margins.java

ChromePdfRenderOptions options = new ChromePdfRenderOptions();
// Set all four margins in millimeters
options.setMarginTop(20);
options.setMarginBottom(20);
options.setMarginLeft(15);
options.setMarginRight(15);
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(
    "<p>Document with custom margins</p>", options);
pdf.saveAs("custom-margins.pdf");

Wenn alle Ränder auf null gesetzt sind, wird der gesamte Weiße Raum entfernt, was für randlose Designs wie Etiketten, Zertifikate oder grafische Layouts nützlich ist.

Für ein funktionierendes Code-Beispiel besuchen Sie das Beispiel für benutzerdefinierte Ränder.

Meine Lieblingsbibliothek dieser Art ist IronPDF. Es ermöglicht eine schnelle und effiziente Bearbeitung von PDF-Dateien. Es verfügt auch über viele wertvolle Funktionen, wie das Exportieren in das PDF/A-Format und das digitale Signieren von PDF-Dokumenten.

Milan Jovanovic

Microsoft MVP

Fallstudie ansehen

IronOCR bedeutet, dass wir jährlich 40.000 $ durch manuelle Verarbeitung einsparen können, während die Produktivität gesteigert wird und Ressourcen für wichtige Aufgaben freigesetzt werden. Ich würde es sehr empfehlen.

Brent Matzelle

Technischer Leiter, OPYN

Fallstudie ansehen

Die Iron Suite spielt eine entscheidende Rolle in unseren Operationen. Diese Werkzeuge erhöhen die Effizienz im gesamten Unternehmen, einschließlich der Erstellung von Grundrissen und der Verbesserung des Bestandsmanagements.

David Jones

Leitender Software-Ingenieur, Agorus Build

Fallstudie ansehen

Wie Füge Ich Kopf- Und Fußzeilen Bei Einem PDF In Java Hinzu?

IronPDF unterstützt zwei Arten von Kopf- und Fußzeilen: textbasiert (TextHeaderFooter) und HTML-basiert (HtmlHeaderFooter). Text-Kopfzeilen sind schnell zu konfigurieren; HTML-Kopfzeilen unterstützen volle Gestaltung und Bilder.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/text-header-footer.java

import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.headerfooter.*;
import com.ironsoftware.ironpdf.render.*;
ChromePdfRenderOptions options = new ChromePdfRenderOptions();
// Configure a text-based header
TextHeaderFooter header = new TextHeaderFooter();
// Use merge fields: {page}, {total-pages}, {date}, {time}, {url}, {html-title}
header.setCenterText("Report Title");
header.setRightText("Page {page} of {total-pages}");
options.setTextHeader(header);
// Configure a text-based footer
TextHeaderFooter footer = new TextHeaderFooter();
footer.setLeftText("Confidential");
footer.setCenterText("{date}");
options.setTextFooter(footer);
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(
    "<h1>Annual Report</h1><p>Content here.</p>", options);
pdf.saveAs("report-with-headers.pdf");

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/html-header.java

import com.ironsoftware.ironpdf.headerfooter.*;
HtmlHeaderFooter header = new HtmlHeaderFooter();
header.setHtmlFragment(
    "<div style='background:#003366;color:white;padding:8px;font-family:Arial;'>"
    + "<img src='/images/logo.png' style='height:30px;float:left;'/>"
    + "<span style='line-height:30px;margin-left:10px;'>Company Report</span>"
    + "</div>"
);
ChromePdfRenderOptions options = new ChromePdfRenderOptions();
options.setHtmlHeader(header);
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(
    "<h1>Q3 Results</h1>", options);
pdf.saveAs("report-with-html-header.pdf");

Wie Wende Ich Ein Wasserzeichen Auf Ein PDF In Java An?

IronPDF wendet Wasserzeichen an, indem HTML-Inhalte auf vorhandene PDF-Seiten gestempelt werden. Dieser Ansatz bietet volle Kontrolle über Positionierung, Transparenz und Gestaltung.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/watermark.java

import com.ironsoftware.ironpdf.*;
// Create the base PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Confidential Report</h1>");
// Apply a diagonal text watermark using HTML stamping
String watermarkHtml =
    "<div style='position:absolute;top:50%;left:50%;transform:translate(-50%,-50%) rotate(-45deg);"
    + "font-size:80px;color:rgba(200,0,0,0.15);font-family:Arial;font-weight:bold;"
    + "white-space:nowrap;pointer-events:none;'>CONFIDENTIAL</div>";
pdf.applyStamp(watermarkHtml);
pdf.saveAs("watermarked-report.pdf");

Die applyStamp Methode akzeptiert Standard-HTML/CSS. Die Verwendung einer halbtransparenten rgba Farbe für den Text stellt sicher, dass das Wasserzeichen sichtbar ist, ohne den Dokumentinhalt darunter zu verdecken.

Für bildbasierte Wasserzeichen oder Wasserzeichen, die auf bestimmte Seitenbereiche angewendet werden, siehe den Anleitung für benutzerdefinierte Wasserzeichen in Java.

Wie komprimiere ich eine PDF-Datei in Java?

Für PDF-Dateien, die Bilder enthalten, kann IronPDF die Dateigröße verringern, indem eingebettete Bilder auf eine niedrigere Auflösung neu abgetastet werden. Verwenden Sie compressImages auf einem vorhandenen PdfDocument.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/compress-pdf.java

// Load an existing PDF or use one created by IronPDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("large-report.pdf"));
// Reduce image quality to 60% (value range: 1–100)
pdf.compressImages(60);
// Save the compressed document
pdf.saveAs("compressed-report.pdf");

Der Qualitätsparameter ist eine Ganzzahl von 1 bis 100, wobei 100 die volle Bildqualität beibehält und niedrigere Werte die Dateigröße auf Kosten der Bildtreue verringern. Ein Wert von 60 bis 80 bietet für die meisten Geschäftsdokumente einen praktischen Ausgleich zwischen Größe und visueller Qualität.

Siehe das Beispiel für PDF-Kompression für weitere Details zu Bildqualitätsgrenzen.

Nächste Schritte

Dieses Tutorial behandelte die drei HTML-zu-PDF-Konvertierungsmethoden (String, URL und Datei) sowie die Seitengröße, Ränder, Kopf- und Fußzeilen, Wasserzeichen und Komprimierung. Dies sind die häufigsten PDF-Formatierungsoperationen for Java-Serveranwendungen.

Um mit IronPDF for Java weiterzugehen:

• Erforschen Sie die vollständigen Codebeispiele für IronPDF for Java als Kopierer-Startpunkte
• Lesen Sie das Beispiel für Einstellungen zur PDF-Erstellung für DPI-, Zoom- und Renderqualitätsoptionen
• Sehen Sie, wie Sie Text und Bilder aus bestehenden PDFs extrahieren
• Lernen Sie, wie Sie PDFs programmatisch drucken aus einer Java-Anwendung
• Durchsuchen Sie die IronPDF for Java API Referenz für die vollständige PdfDocument Methodenliste

Starten Sie eine kostenlose Testversion um PDFs ohne Wasserzeichen zu erstellen oder sehen Sie sich die Lizenzierungsoptionen an um IronPDF in ein Produktionsprojekt einzufügen.

---

Tutorial Schnellzugriff

Dieses Tutorial als Java-Quellcode herunterladen

Der vollständige HTML zu PDF Java Quellcode für dieses Tutorial steht kostenlos als gezipptes IntelliJ-Projekt zum Herunterladen zur Verfügung.

Herunterladen

Entdecken Sie dieses Tutorial auf GitHub

Der Quellcode für dieses Projekt ist auf GitHub als IntelliJ IDEA-Projekt verfügbar, das auch in Eclipse oder andere Java-IDEs importiert werden kann.

IronPDF for Java Format-pdfs-Beispiele

Sehen Sie sich die API-Referenz an

Entdecken Sie die API-Referenz für IronPDF for Java, die alle Details zu Klassen, Methoden, Feldern und Enumerationen im com.ironsoftware.ironpdf-Paket abdeckt.

Sehen Sie die IronPDF Java API-Referenz