Jak tworzyć pliki PDF w Java

Czym jest IronPDF for Java i dlaczego warto go używać?

IronPDF for Java to biblioteka do generowania i manipulacji plikami PDF zbudowana na silniku renderującym Chromium. Ponieważ renderuje HTML dokładnie tak, jak Chrome, radzi sobie z złożonymi układami, niestandardowymi czcionkami, animacjami CSS, treścią generowaną przez JavaScript i osadzonymi obrazami bez potrzeby ręcznego kodowania układu.

Biblioteka obejmuje cały cykl życia PDF w jednej zależności. Deweloperzy mogą tworzyć dokumenty od zera, konwertować istniejącą treść HTML, łączyć lub dzielić pliki, dodawać znaki wodne, szyfrować hasłami, wyodrębniać tekst i obrazy, oraz generować formularze wypełnialne, wszystko za pomocą spójnego API. Dla przepływów pracy opartych na HTML, IronPDF unika ręcznych obliczeń układu strony wymaganych przez niższopoziomowe biblioteki PDF, takie jak Apache PDFBox.

W odróżnieniu od iText, który wymaga otwartego licencjonowania AGPL na większość zastosowań komercyjnych, IronPDF dostarcza przyjazne komercjalizacyjne licencjonowanie i nie wymaga złożonej weryfikacji zgodności licencyjnej. IronPDF for Java jest dostarczane jako artefakt Maven i działa na Windows, Linux i macOS. Integruje się z Spring Boot, Jakarta EE oraz samodzielnymi aplikacjami Java. Biblioteka wspiera również wdrożenia serwerowe na AWS, Azure oraz Google Cloud.

Jakie są wymagania wstępne do używania IronPDF w 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'

Jakie są wymagane importy i konfiguracja?

Dodaj te polecenia importu na początku swojego pliku źródłowego Java:

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

JAVA

Przed generowaniem jakichkolwiek plików PDF ustaw swój klucz licencyjny w metodzie main lub podczas uruchamiania aplikacji:

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

JAVA

Uwagi: Bez ważnego klucza licencyjnego, pliki PDF są generowane z próbnym znakiem wodnym. Kup licencję lub rozpocznij bezpłatny okres próbny, aby ją usunąć. Zobacz używanie kluczy licencyjnych w Java dla dodatkowych opcji konfiguracji.

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 utworzyć PDF z ciągu HTML w Java?

Przekaż dowolny ciąg HTML bezpośrednio do PdfDocument.renderHtmlAsPdf(). IronPDF zwraca instancję PdfDocument reprezentującą gotowy dokument w pamięci. Wywołaj saveAs(), aby zapisać go na dysku.

: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() obsługuje pełną specyfikację HTML5 i CSS3, w tym czcionki webowe, Flexbox, Grid layouts i wykonanie JavaScript. Poniższy przykład używa wieloliniowego szablonu HTML z niestandardowymi stylami:

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

Przykład faktury powyżej używa bloków tekstowych Java (dostępnych od Java 13) dla czystszych wieloliniowych HTML. Dla starszych wersji Java możesz połączyć ciąg HTML ręcznie lub załadować go z pliku przy użyciu renderHtmlFileAsPdf(). Dla ogólniejszego spojrzenia na konwersję HTML do PDF, w tym renderowanie JavaScript, zobacz HTML do PDF tutorial dla Java.

Jak utworzyć PDF z lokalnego pliku HTML w Java?

Użyj PdfDocument.renderHtmlFileAsPdf(), aby przekonwertować plik HTML przechowywany na lokalnym systemie plików. Przekaż ścieżkę jako ciąg; ścieżki względne są rozwiązywane względem bieżącego katalogu roboczego:

: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 rozwiązuje wszystkie odwoływane zasoby (zewnętrzne pliki CSS, lokalne obrazy i biblioteki JavaScript) względem katalogu pliku HTML. To oznacza, że możesz zbudować kompletny szablon HTML z powiązanymi arkuszami stylów i uruchomić go przez IronPDF, nie modyfikując żadnych ścieżek zasobów.

Metoda akceptuje zarówno ścieżkę String, jak i obiekt java.nio.file.Path. Do użycia produkcyjnego preferuj ścieżki absolutne, aby uniknąć niejednoznaczności w ścieżkach roboczych. Zobacz przykład konwersji pliku HTML na PDF dla pełnego funkcjonującego przykładu.

Jak stworzyć PDF z URL strony internetowej w Java?

PdfDocument.renderUrlAsPdf() pobiera dynamiczny URL, renderuje go za pomocą Chromium i zwraca PDF. Jest to przydatne do robienia zrzutów kokpitu, generowania paragonów PDF z hostowanych stron paragonów lub archiwizowania treści web:

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

Dla stron zabezpieczonych uwierzytelnianiem HTTP, prześlij dane uwierzytelniające przez 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"));

Zobacz przykład kodu konwersji URL na PDF dla szczegółów. Dla bardziej złożonych ścieżek logowania przy użyciu ciasteczek lub uwierzytelniania opartego na formularzach, zobacz obsługę logowania na stronach internetowych.

Jak kontrolować rozmiar strony, orientację i marginesy?

Użyj ChromePdfRenderOptions, aby dostosować fizyczny układ wyjściowego PDF. Przekaż skonfigurowane opcje jako drugi argument do dowolnej metody renderowania. Najczęstsze ustawienia to orientacja strony, rozmiar papieru i marginesy:

: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 udostępnia ponad 30 ustawień oprócz tych pokazanych powyżej, w tym DPI, limit czasu wykonywania JavaScript, współczynnik powiększenia i typ mediów CSS. Zobacz ustawienia generowania PDF dla pełnej listy. Dla niestandardowych rozmiarów papieru nie wchodzących w skład wyliczenia PaperSize, zobacz niestandardowe rozmiary papieru PDF.

Jak dodać ochronę hasłem do PDF w Java?

SecurityOptions kontroluje hasła odczytu i właściciela oraz flagi uprawnień. Przekaż SecurityOptions do SecurityManager dokumentu przed zapisaniem:

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

Dla ściślejszej kontroli, ustaw hasło właściciela i ogranicz konkretne operacje:

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

Otwieranie PDF wyświetla monit, aby wprowadzić hasło:

Czytniki PDF wyświetlają monit o hasło, jeżeli dokument jest zabezpieczony hasłem użytkownika.

Po wprowadzeniu poprawnego hasła PDF otwiera się i wyświetla pełną treść:

Dokument renderuje się normalnie po podaniu poprawnego hasła.

Zobacz ustawienia bezpieczeństwa i metadanych dla pełnej listy flag uprawnień.

Jak generować PDF w aplikacji Spring Boot?

IronPDF integruje się bezpośrednio z Spring Boot. Zwróć PDF jako odpowiedź HTTP w postaci tablicy bajtów z dowolnej metody kontrolera; ten wzorzec działa do generowania raportów na żądanie, pobierania faktur i eksportów danych.

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

Metoda getBinaryData() zwraca PDF jako tablicę bajtów, co Spring Boot przesyła bezpośrednio do klienta. Na dysk nie są zapisywane żadne pliki tymczasowe. Dla wdrożeń o dużej przepustowości zainicjuj License.setLicenseKey() w metodzie @PostConstruct lub aplikacyjnym nasłuchiwaczu startowym zamiast na żądanie.

Jakie są następne kroki do tworzenia PDF w Java?

Przewodnik ten pokazał cztery podejścia do generowania PDF w Java przy użyciu IronPDF: renderowanie ciągu HTML, konwersja lokalnego pliku, przechwytywanie URL oraz strumieniowanie odpowiedzi HTTP w Spring Boot. Wszystkie metody udostępniają ten sam PdfDocument API, ChromePdfRenderOptions dla kontroli formatowania oraz SecurityOptions dla ochrony dostępu.

IronPDF for Java obsługuje również dodawanie i nakładanie znaków wodnych, łączenie wielu plików PDF, dzielenie PDF na pojedyncze strony, dodawanie podpisów cyfrowych, renderowanie wykresów JavaScript do PDF oraz drukowanie PDF programowo.

Rozpocznij darmowy okres próbny aby generować PDF bez znaków wodnych lub zobacz opcje licencjonowania, aby wybrać plan pasujący do twojego projektu. Gotowy na więcej? Sprawdź pełną stronę samouczka IronPDF dla Java.