HTML do PDF w Java

Opcja 1: Zainstaluj IronPDF jako zależność Maven

Aby zainstalowac IronPDF w projekcie Java za pomoca Maven, dodaj nastepujace artefakty do sekcji zaleznosci w pliku pom.xml projektu Java.

<dependencies>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>
</dependencies>

<dependencies>

    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>[LATEST_VERSION]</version>
    </dependency>
</dependencies>

Pierwszy artefakt odwołuje się do najnowszej wersji biblioteki IronPDF. Drugi artefakt odwołuje się do implementacji SLF4J. Ta zależność jest wymagana, aby umożliwić silnikowi renderowania IronPDF generowanie wiadomości logowania podczas wykonywania. Inżynierowie oprogramowania mogą zastąpić tę zależność innymi dostawcami logowania (takimi jak Logback i Log4J); lub calkowicie pominac, jesli nie potrzebuja logowania lub nie chca go.

Uruchom polecenie mvn install w terminalu w katalogu głównym projektu Java, aby pobrać wcześniej wspomniane biblioteki.

Opcja 2: Zainstaluj JAR IronPDF ręcznie

Deweloperzy, którzy wolą nie używać Maven lub innego systemu zarządzania zależnościami, będą musieli pobrać plik JAR biblioteki IronPDF (i opcjonalną implementację SLF4J) i ręcznie dodać go do ścieżki klas swojego projektu.

Pobierz plik JAR IronPDF bezpośrednio z pobierania JAR IronPDF (lub z repozytorium Maven).

2.1 Importuj pakiet IronPDF

Wszystkie komponenty konwersji i przetwarzania IronPDF są zawarte w pakiecie com.ironsoftware.ironpdf.

Umieść następujące stwierdzenie importu na początku plików źródłowych Java (gdzie używane będzie IronPDF), aby uczynić te komponenty dostępnymi dla kodu źródłowego aplikacji.

// Import statement for IronPDF for Java
import com.ironsoftware.ironpdf.*;

// Import statement for IronPDF for Java
import com.ironsoftware.ironpdf.*;

2.2. Ustaw klucz licencyjny (opcjonalnie)

IronPDF dla Java jest darmowy w użyciu. Jednak dla darmowych użytkowników oznacza to, że dokumenty PDF będą oznaczone kafelkowym znakiem wodnym w tle (jak pokazano na poniższym obrazku).

Aby używać IronPDF do generowania PDF bez znaków wodnych, biblioteka musi używać ważnego klucza licencyjnego. Linia kodu poniżej konfiguruje bibliotekę z kluczem licencyjnym.

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

Klucz licencyjny powinien być ustawiony przed generowaniem plików PDF lub dostosowywaniem treści plików. Zalecamy, aby metoda setLicenseKey była wywoływana przed wszystkimi innymi liniami kodu.

Kup klucz licencyjny na stronie licencji IronPDF, lub skontaktuj się z nami, aby uzyskać darmowy klucz licencyjny na okres próbny.

2.3 Ustaw lokalizację pliku dziennika (opcjonalnie)

Domyślnie (i przy założeniu, że zainstalowano dostawcę SLF4J), IronPDF generuje wiadomości dziennika do pliku tekstowego o nazwie IronPdfEngine.log umieszczonego w katalogu głównym aplikacji Java.

Aby określić inną nazwę i lokalizację pliku dziennika, użyj metody Settings.setLogPath:

// Set a log path
Settings.setLogPath(Paths.get("IronPdfEngine.log"));

// Set a log path
Settings.setLogPath(Paths.get("IronPdfEngine.log"));

Settings.setLogPath należy wywołać przed użyciem jakichkolwiek metod konwersji i manipulacji PDF.

2.4. Tworzenie PDF z ciągu HTML

PdfDocument.renderHtmlAsPdf przekształca ciąg treści HTML w dokument PDF.

Poniższy przykład kodu używa pojedynczego elementu nagłówkowego do wygenerowania nowego pliku.

// Convert HTML string to PDF document
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
// Save the PDF document
pdf.saveAs("htmlstring_to_pdf.pdf");

// Convert HTML string to PDF document
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
// Save the PDF document
pdf.saveAs("htmlstring_to_pdf.pdf");

Metoda renderHtmlAsPdf może korzystać z obrazów, arkuszy stylów i skryptów znajdujących się w folderach na komputerze lub dysku sieciowym. Następny przykład generuje dokument PDF z HTML odwołującym się do pliku CSS i obrazu znajdującego się w folderze assets:

// HTML string with external assets
String html = "<html><head><title>Hello world!</title><link rel='stylesheet' href='assets/style.css'></head><body><h1>Hello from IronPDF!</h1><a href='https://ironpdf.com/java/'><img src='assets/logo.png' /></a></body></html>";
// Convert HTML to PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);
// Save the PDF document
pdf.saveAs("output.pdf");

// HTML string with external assets
String html = "<html><head><title>Hello world!</title><link rel='stylesheet' href='assets/style.css'></head><body><h1>Hello from IronPDF!</h1><a href='https://ironpdf.com/java/'><img src='assets/logo.png' /></a></body></html>";
// Convert HTML to PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);
// Save the PDF document
pdf.saveAs("output.pdf");

Drugi (opcjonalny) argument metody renderHtmlAsPdf pozwala programistom określić ścieżkę bazową, z której będą odwoływać się do zasobów sieciowych. Ta ścieżka może prowadzić do katalogu w lokalnym systemie plików lub nawet ścieżki URL.

Dowiedz się więcej o metodzie renderHtmlAsPdf z tego przykładu kodu używającego HTML do stworzenia PDF, lub przeczytaj o niej na stronie Dokumentacja API dla klasy PdfDocument, aby uzyskać jeszcze większą kontrolę nad renderowanym HTML do PDF.

2.5. Tworzenie PDF z URL

Deweloperzy mogą konwertować strony internetowe na dokumenty PDF, używając metody PdfDocument.renderUrlAsPdf IronPDF.

Następny przykład renderuje artykuł w Wikipedii na zawartość PDF.

// Convert a URL to PDF
PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
// Save the PDF document
pdf.saveAs("url_to_pdf.pdf");

// Convert a URL to PDF
PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
// Save the PDF document
pdf.saveAs("url_to_pdf.pdf");

Dowiedz się więcej o konwertowaniu stron internetowych na zawartość PDF z tego przykładu kodu o konwertowaniu URL na PDF.

2.6. Tworzenie PDF z pliku HTML

IronPDF może również renderować dokument HTML przechowywany na lokalnym systemie plików bezpośrednio do jego odpowiedniego formatu PDF.

Następny przykład kodu używa tej faktury jako demonstracji w świecie rzeczywistym jak dobrze IronPDF potrafi konwertować pliki HTML.

Znaczniki HTML dla faktury odtworzono tutaj dla wygody:

<html>
<head>
    <meta charset="utf-8">
    <title>Invoice</title>
    <link rel="stylesheet" href="style.css">
    <link rel="license" href="https://www.opensource.org/licenses/mit-license/">
    <script src="script.js"></script>
</head>
<body>
<header>
    <h1>Invoice</h1>
    <address contenteditable>
        <p>Jonathan Neal</p>
        <p>101 E. Chapman Ave<br>Orange, CA 92866</p>
        <p>(800) 555-1234</p>
    </address>
    <span><img alt="" src="http://www.jonathantneal.com/examples/invoice/logo.png"><input type="file" accept="image/*"></span>
</header>
<article>
    <h1>Recipient</h1>
    <address contenteditable>
        <p>Some Company<br>c/o Some Guy</p>
    ...
</body>
</html>

<html>
<head>
    <meta charset="utf-8">
    <title>Invoice</title>
    <link rel="stylesheet" href="style.css">
    <link rel="license" href="https://www.opensource.org/licenses/mit-license/">
    <script src="script.js"></script>
</head>
<body>
<header>
    <h1>Invoice</h1>
    <address contenteditable>
        <p>Jonathan Neal</p>
        <p>101 E. Chapman Ave<br>Orange, CA 92866</p>
        <p>(800) 555-1234</p>
    </address>
    <span><img alt="" src="http://www.jonathantneal.com/examples/invoice/logo.png"><input type="file" accept="image/*"></span>
</header>
<article>
    <h1>Recipient</h1>
    <address contenteditable>
        <p>Some Company<br>c/o Some Guy</p>
    ...
</body>
</html>

Załóżmy, że plik HTML został zapisany w folderze o nazwie "invoices" wraz z jego plikiem CSS i plikiem JavaScript. Możemy użyć IronPDF do konwersji pliku HTML w następujący sposób:

// Convert an HTML file to PDF
PdfDocument pdf = PdfDocument.renderHtmlFileAsPdf("C:/invoices/TestInvoice1.html");
// Save the PDF document
pdf.saveAs("htmlfile_to_pdf.pdf");

// Convert an HTML file to PDF
PdfDocument pdf = PdfDocument.renderHtmlFileAsPdf("C:/invoices/TestInvoice1.html");
// Save the PDF document
pdf.saveAs("htmlfile_to_pdf.pdf");

Podobnie jak w przykładach konwersji z ciągu HTML na PDF, IronPDF prawidłowo rozwiązuje wszelkie względne URL w dokumencie HTML do ich poprawnych ścieżek w systemie plików. W rezultacie plik PDF, który ten przykład produkuje, jest w stanie perfekcyjnie uchwycić wizualne wpływy, które zwykle mają odniesione arkusze stylów i skrypty na stronę internetową.