HTML do PDF w Java

Jak dodać IronPDF do projektu Maven w Java?

Dodanie IronPDF do projektu Maven wymaga dwóch wpisów w bloku zależności pom.xml projektu. Pierwszy pobiera bibliotekę IronPDF; druga dodaje dostawcę logowania SLF4J, aby IronPDF mógł pisać komunikaty silnika podczas działania.

//: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>

Artefakt ironpdf odnosi się do najnowszego wydania i changelogu IronPDF for Java. Zależność slf4j-simple zapewnia podstawowy backend logowania. Możesz zastąpić go Logback lub Log4J w miarę potrzeb, lub całkowicie pominąć, aby zapobiec wyjściu dziennika.

Po dodaniu obu wpisów uruchom mvn install z katalogu głównego projektu, aby pobrać artefakty. Maven rozwiązuje zależność względem Maven Central.

Sprawdź stronę Maven Central dla com.ironsoftware:ironpdf, aby potwierdzić najnowszy numer wersji przed dodaniem go do twojego pliku pom.xml.

Jak ręcznie zainstalować JAR IronPDF w Java?

Projekty, które nie używają Maven lub innego menedżera zależności mogą dodać IronPDF przez pobranie JAR bezpośrednio i uwzględnienie go w ścieżce klas. Przejdź do strony pobierania IronPDF for Java i pobierz plik fat-JAR.

Fat-JAR zawiera wszystkie zależności, więc poza głównym artefaktem nie są wymagane dodatkowe wpisy ścieżki klas. Opcjonalnie pobierz plik JAR implementujący SLF4J, aby włączyć logowanie.

Dodaj oba JAR-y do klasy ścieżki projektu za pomocą panelu zarządzania bibliotekami IDE lub za pomocą wpisów -classpath przy kompilacji i uruchamianiu z terminala.

Jak zaimportować IronPDF do plików źródłowych Java?

Pakiet com.ironsoftware.ironpdf zawiera wszystkie komponenty konwersji i przetwarzania. Umieść poniższe polecenie importu na górze każdego pliku Java, który wywołuje metody IronPDF.

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

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

Docelowy import, który nazywa konkretne klasy, jest również ważny: import com.ironsoftware.ironpdf.PdfDocument;. Import uniwersalny jest wygodny podczas eksploracji.

Jak ustawić klucz licencyjny w IronPDF for Java?

IronPDF for Java jest darmowy do użycia bez klucza licencyjnego, ale aplikuje on kafelkowy znak wodny do wszystkich wygenerowanych lub zmodyfikowanych dokumentów PDF. Aby usunąć znak wodny, dostarcz ważny klucz licencyjny przed wywołaniem jakiejkolwiek metody konwersji lub manipulacji.

//: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");

Umieść wywołanie setLicenseKey przy uruchamianiu aplikacji, przed wywołaniem jakiejkolwiek metody PdfDocument. Zakup klucz licencyjny lub rozpocznij darmowy okres próbny, aby generować PDF bez znaków wodnych.

Ważny klucz licencyjny usuwa kafelkowy znak wodny z wygenerowanych PDF. Uzyskaj jeden na stronie licencjonowania IronPDF lub poproś o darmowy okres próbny.

: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"));

Jak skonwertować ciąg HTML na PDF w Java?

PdfDocument.renderHtmlAsPdf(String html) konwertuje każde poprawne znacznikowanie HTML na dokument PDF. Metoda przyjmuje surowy ciąg HTML i zwraca obiekt PdfDocument, który można zapisać, połączyć lub dalej zmodyfikować.

: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 renderuje kod HTML bezpośrednio do PDF z dokładnością pikseli. Wynik pokazany tutaj był wygenerowany przez powyższy przykład kodu.

Silnik renderujący oparty jest na Chromium, więc każdy HTML, CSS lub JavaScript działający w Chrome zostanie poprawnie wyrenderowany w PDF. To obejmuje układy Flexbox, sieci CSS, czcionki webowe, SVG i wykresy napędzane JavaScriptem.

Przeładowana wersja metody przyjmuje drugi argument z ścieżką bazową: renderHtmlAsPdf(String html, String basePath). Ścieżka bazowa jest używana do rozwiązywania względnych odwołań do lokalnych arkuszy stylów, obrazów i skryptów.

: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");

Ścieżka bazowa może wskazywać na katalog w lokalnym systemie plików lub na zdalny URL. IronPDF pobiera odwołane zasoby z tej lokalizacji podczas renderowania.

Gdy ścieżka bazowa jest dostarczona, IronPDF rozwiązuje lokalne odniesienia CSS i obrazów, aby wyprodukować w pełni stajlowany PDF.

Aby przyjrzeć się bliżej tej metodzie, zobacz przykład kodu konwersji ciągu HTML na PDF.

Jak skonwertować URL na PDF w Java?

PdfDocument.renderUrlAsPdf(String url) pobiera stronę pod podanym adresem URL i renderuje pełną DOM (w tym wykonanie JavaScript), zanim zapisze wynik jako PDF.

: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 przechwytuje pełny wyrenderowany stan strony internetowej, w tym dynamiczną treść wyprodukowaną przez JavaScript.

Silnik renderujący Chromium pobiera zewnętrzne arkusze stylów, czcionki i pliki JavaScript, więc wynikowy PDF precyzyjnie odzwierciedla wizualny stan strony. Ta metoda jest dobrze dostosowana do generowania raportów z pulpitów nawigacyjnych, archiwizacji publicznej treści internetowej lub konwersji wizualizacji danych, które zależą od renderowania po stronie klienta.

Zobacz dedykowany przykład konwersji URL na PDF po dodatkowe opcje takie jak niestandardowe nagłówki żądań i uwierzytelnianie.

Jak przekonwertować plik HTML na PDF w Java?

PdfDocument.renderHtmlFileAsPdf(String filePath) odczytuje plik HTML z lokalnego systemu plików i konwertuje go na PDF. Metoda automatycznie rozwiązuje wszelkie odniesienia do zasobów względnych w pliku HTML względem katalogu pliku.

: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");

Metoda poprawnie obsługuje projekty HTML złożone z wielu plików. W powyższym przykładzie, jeśli TestInvoice1.html odwołuje się do arkusza stylów w tym samym katalogu, IronPDF stosuje ten arkusz podczas renderowania. Rezultatem jest PDF, który odpowiada wyglądowi renderowanemu przez przeglądarkę pliku źródłowego.

Używaj absolutnych ścieżek plików podczas wywoływania renderHtmlFileAsPdf z aplikacji serwerowej. Ścieżki względne są rozwiązywane względem katalogu roboczego JVM, który może różnić się od lokalizacji pliku HTML.)}]

Ta metoda jest szczególnie przydatna dla przepływów pracy generujących PDF-y, które utrzymują szablony HTML na dysku: generatory faktur, szablony raportów i systemy wyjścia formularzy to popularne przypadki użycia.

Jak ustawić rozmiar strony PDF i orientację w Java?

Rozmiar strony i orientacja są kontrolowane przez klasę ChromePdfRenderOptions. Utwórz instancję ChromePdfRenderOptions, skonfiguruj właściwości i przekaż ją jako drugi argument do każdego wywołania renderHtmlAsPdf.

: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 zawiera standardowe opcje takie jak A4, Letter, Legal, A3 i A5. PaperOrientation akceptuje Portrait (domyślnie) lub Landscape.

Dla niestandardowych wymiarów, użyj setCustomPaperSizeInMillimeters(double width, double height) lub 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");

Zobacz przykład niestandardowego rozmiaru papieru PDF dla pełnej listy stałych PaperSize i opcji rozmiarowania.

Jak ustawić niestandardowe marginesy w PDF w Java?

Rozmiary marginesów są również ustawiane za pomocą ChromePdfRenderOptions. Biblioteka udostępnia oddzielne metody set dla górnych, dolnych, lewych i prawych marginesów, przyjmując wartości w milimetrach.

: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");

Ustawienie wszystkich marginesów na zero całkowicie usuwa puste przestrzenie, co jest przydatne dla projektów pełnoekranowych takich jak etykiety, certyfikaty czy układy graficzne.

Dla przykładowego kodu odwiedź przykład niestandardowych marginesów.

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak dodać nagłówki i stopki do PDF w Java?

IronPDF obsługuje dwa rodzaje nagłówków i stopek: oparte na tekście (TextHeaderFooter) i oparte na HTML (HtmlHeaderFooter). Tekstowe nagłówki są szybkie do skonfigurowania; Nagłówki HTML obsługują pełne stylizowanie oraz obrazy.

: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");

Jak nałożyć znak wodny na PDF w Java?

IronPDF nakłada znaki wodne przez dodawanie treści HTML na istniejące strony PDF. To podejście daje pełną kontrolę nad pozycjonowaniem, przezroczystością i stylizacją.

: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");

Metoda applyStamp akceptuje standardowy HTML/CSS. Użycie półprzezroczystego koloru rgba dla tekstu zapewnia, że znak wodny jest widoczny, nie zacierając treści dokumentu.

Dla znaków wodnych opartych na obrazach lub znaków wodnych stosowanych do określonych zakresów stron, zobacz przewodnik po znakach wodnych dla Java.

Jak skompresować plik PDF w Java?

Dla plików PDF zawierających obrazy, IronPDF może zmniejszyć rozmiar pliku poprzez zmniejszenie rozdzielczości osadzonych obrazów. Używaj compressImages na istniejącym 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");

Parametr jakości to liczba całkowita od 1 do 100, gdzie 100 zachowuje pełną jakość obrazu, a niższe wartości zmniejszają rozmiar pliku kosztem wierności obrazu. Wartość od 60 do 80 zapewnia praktyczną równowagę między rozmiarem a jakością wizualną dla większości dokumentów biznesowych.

Zobacz przykład kompresji PDF dla więcej szczegółów dotyczących progów jakości obrazu.

Kolejne kroki

Ten samouczek obejmował trzy metody konwersji HTML na PDF (ciąg, URL i plik) wraz z określaniem rozmiaru strony, marginesów, nagłówków, stopek, znaków wodnych i kompresji. To są najczęstsze operacje formatowania PDF dla aplikacji serwerowych w Java.

Aby pójść dalej z IronPDF for Java:

• Przeglądaj przykłady kodu dla IronPDF for Java jako punkty startowe do kopiowania i wklejania
• Przeczytaj przykład ustawień generatora PDF dla opcji DPI, powiększenia i jakości renderowania
• Zobacz, jak wyciągnąć tekst i obrazy z istniejących PDF
• Naucz się, jak drukować PDF programowo z aplikacji Java Przeglądaj dokumentację API IronPDF for Java dla pełnej listy metod PdfDocument

Rozpocznij darmowy okres próbny aby generować PDFy bez znaków wodnych, lub zobacz opcje licencjonowania aby dodać IronPDF do projektu produkcyjnego.

---

Szybki dostęp do samouczka

Pobierz ten samouczek jako kod źródłowy Java

Pełny kod źródłowy HTML to PDF w Java dla tego samouczka jest dostępny do pobrania za darmo jako spakowany projekt IntelliJ.

Pobierz

Zapoznaj się z tym samouczkiem na GitHubie

Kod źródłowy dla tego projektu jest dostępny na GitHub jako projekt IntelliJ IDEA, który może być również zaimportowany do Eclipse lub innych IDE Java.

IronPDF for Java przykłady formatowania PDF

Zobacz Dokumentację API

Przeglądaj dokumentację referencyjną API dla IronPDF for Java, obejmującą szczegóły wszystkich klas, metod, pól i wyliczeń w pakiecie com.ironsoftware.ironpdf.

Zobacz dokumentację referencyjną API IronPDF Java