Jedną z największych zalet IronPDF for Java jest możliwość pracy z szablonami PDF. Szablon PDF to gotowy plik PDF zawierający symbole zastępcze dla treści dynamicznej. Korzystając z IronPDF, można łatwo zastąpić te symbole zastępcze rzeczywistymi danymi, aby wygenerować nowy, dostosowany dokument w formacie PDF.

IronPDF

IronPDF to biblioteka Java opracowana i utrzymywana przez firmę Iron Software. Zapewnia łatwy w użyciu interfejs, który eliminuje wiele złożonych aspektów generowania plików PDF, pozwalając programistom skupić się na treści swoich plików PDF, a nie na szczegółach dotyczących sposobu ich generowania. IronPDF oferuje również szereg funkcji ułatwiających pracę z szablonami PDF, formularzami do wypełnienia i podpisami cyfrowymi.

Ten samouczek przeprowadzi Cię przez kroki niezbędne do utworzenia pliku PDF z szablonu przy użyciu IronPDF w Javie.

Pierwszym krokiem jest utworzenie projektu.

Krok 1: Utwórz nowy projekt Java

Oto kroki, które należy wykonać, aby utworzyć nowy projekt Java przy użyciu IntelliJ IDEA:

1. Otwórz IntelliJ IDEA i wybierz "Utwórz nowy projekt" na ekranie powitalnym lub z menu "Plik".
2. Wybierz "Java" z menu po lewej stronie i wybierz wersję JDK, której chcesz użyć w swoim projekcie. Kliknij "Dalej".
3. Wybierz nazwę i lokalizację projektu, a następnie wybierz typ projektu. Możesz wybierać spośród wielu różnych typów projektów, takich jak "Aplikacja Java", "Biblioteka Java" lub "Aplikacja JavaFX". Kliknij "Dalej".
4. Skonfiguruj ustawienia projektu. Można określić zestaw SDK projektu, poziom językowy projektu oraz inne ustawienia. Możesz również utworzyć moduł lub wybrać istniejący. Kliknij "Dalej".
5. Wybierz szablon projektu. Możesz utworzyć pusty projekt, projekt z przykładowym kodem lub zaimportować istniejący projekt. Kliknij "Zakończ".

Utwórz nowy projekt Java przy użyciu IntelliJ IDEA

Krok 2: Dodaj bibliotekę IronPDF do swojego projektu

Drugim krokiem jest dodanie biblioteki IronPDF do projektu Java za pomocą pliku XML. Można to zrobić, dodając poniższą zależność do pliku projektu pom.xml:

<!-- Add this dependency to use IronPDF in your Java project -->
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>VERSION_NUMBER</version> <!-- Specify the version number -->
</dependency>

<!-- Add this dependency to use IronPDF in your Java project -->
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>VERSION_NUMBER</version> <!-- Specify the version number -->
</dependency>

Krok 3: Utwórz szablon PDF

Następnie należy utworzyć szablon PDF, który posłuży do wygenerowania pliku PDF. Szablon PDF można utworzyć za pomocą dowolnego edytora plików PDF. Szablon może zawierać symbole zastępcze, które zostaną zastąpione danymi dynamicznymi w czasie wykonywania.

Załóżmy, że mamy do czynienia z przypadkiem, w którym wydano pewną liczbę certyfikatów dla 50 studentów. Obecnie tworzenie oddzielnych certyfikatów dla każdego użytkownika jest bardzo pracochłonnym zadaniem. W związku z tym należy skorzystać z szablonu i po prostu zmienić nazwę, korzystając z poniższego programu demonstracyjnego.

Przykładowy obraz szablonu certyfikatu

Krok 4: Tworzenie dokumentów PDF na podstawie szablonu

Po utworzeniu szablonu certyfikatu w formacie PDF pierwszym krokiem jest załadowanie go do aplikacji Java. Klasa IronPDF PdfDocument służy do załadowania szablonu PDF do pamięci. Oto przykładowy fragment kodu pokazujący, jak załadować szablon PDF przy użyciu IronPDF:

// Load the PDF template into memory using IronPDF
PdfDocument pdfDoc = PdfDocument.fromFile(Paths.get("CERTIFICATE.pdf"));

// Load the PDF template into memory using IronPDF
PdfDocument pdfDoc = PdfDocument.fromFile(Paths.get("CERTIFICATE.pdf"));

Teraz napiszmy przykładowy kod, który utworzy 5 certyfikatów na podstawie podanego szablonu.

import com.ironsoftware.ironpdf.PageSelection;
import com.ironsoftware.ironpdf.PdfDocument;

import java.io.IOException;
import java.nio.file.Paths;

public class CertificateGenerator {
    public static void main(String[] args) throws IOException {
        // Array of student names
        String[] studentNames = {"Georgia Wade", "Juliet Dave", "Olive Seth", "Miles Jorg", "Oscar Den"};

        // Iterate through each student's name
        for (String name : studentNames) {
            // Load the PDF template
            PdfDocument pdfDoc = PdfDocument.fromFile(Paths.get("CERTIFICATE.pdf"));
            
            // Replace the placeholder text with the student's name
            pdfDoc.replaceText(PageSelection.firstPage(), "Recipient Name", name);
            
            // Save the new PDF with the student's name as the file name
            pdfDoc.saveAs(Paths.get("Certificate/" + name + ".pdf"));
        }
    }
}

import com.ironsoftware.ironpdf.PageSelection;
import com.ironsoftware.ironpdf.PdfDocument;

import java.io.IOException;
import java.nio.file.Paths;

public class CertificateGenerator {
    public static void main(String[] args) throws IOException {
        // Array of student names
        String[] studentNames = {"Georgia Wade", "Juliet Dave", "Olive Seth", "Miles Jorg", "Oscar Den"};

        // Iterate through each student's name
        for (String name : studentNames) {
            // Load the PDF template
            PdfDocument pdfDoc = PdfDocument.fromFile(Paths.get("CERTIFICATE.pdf"));
            
            // Replace the placeholder text with the student's name
            pdfDoc.replaceText(PageSelection.firstPage(), "Recipient Name", name);
            
            // Save the new PDF with the student's name as the file name
            pdfDoc.saveAs(Paths.get("Certificate/" + name + ".pdf"));
        }
    }
}

Poniżej znajdują się logi wyjściowe:

Wynik

Powyższy kod tworzy tablicę nazwisk uczniów, a następnie wykorzystuje bibliotekę IronPDF do zastąpienia tekstu zastępczego w istniejącym szablonie PDF imieniem każdego ucznia, po czym zapisuje nową kopię pliku PDF z imieniem ucznia jako nazwą pliku.

Oto jak działa ten kod:

1. Tablica studentNames jest zdefiniowana i zainicjowana pięcioma imionami studentów.
2. Pętla for iteruje przez każde imię w tablicy studentNames.
3. Metoda [PdfDocument.fromFile](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#fromFile(java.nio.file.Path) ładuje plik szablonu PDF o nazwie "CERTIFICATE.pdf" do obiektu PdfDocument.
4. Metoda PdfDocument.replaceText służy do zastąpienia tekstu "Recipient Name" w szablonie PDF aktualnym imieniem studenta.
5. Metoda [PdfDocument.saveAs](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#saveAs(java.lang.String) zapisuje zmodyfikowany plik PDF z imieniem studenta jako nazwa pliku w katalogu "Certificate".
6. Pętla trwa do momentu przetworzenia wszystkich nazwisk uczniów.

W ten sposób generowanych jest wiele certyfikatów, każdy z unikalnym imieniem i nazwiskiem ucznia, na podstawie jednego szablonu PDF. To samo podejście można wykorzystać do generowania dokumentów PDF przy użyciu dowolnego szablonu.

Wygenerowane pliki PDF

Wyniki w formacie PDF

Plik wyjściowy certyfikatu

Poniżej znajduje się certyfikat wygenerowany przez ten program demonstracyjny.

Wynik certyfikatu

Krok 5: Utwórz szablon PDF na podstawie szablonu HTML

W tym przykładzie plik HTML zostanie wykorzystany do utworzenia szablonu PDF, a następnie ten szablon posłuży do wygenerowania dokumentu PDF.

Oto plik HTML służący jako przykład.

Wynik w formacie HTML

Rozważmy poniższy przykład kodu służący do utworzenia nowego dokumentu na podstawie podanego formatu HTML.

import com.ironsoftware.ironpdf.PdfDocument;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

public class HtmlToPdfExample {
    public static void main(String[] args) throws IOException {
        // Path to the HTML template
        Path fileName = Path.of("D:\\index.html");
        
        // Dynamic data to replace placeholders in the template
        String userName = "Mike";
        String title = "Sample PDF File";
        String body = "This is the body of our template PDF";
        
        // Read the HTML file content as a string
        String htmlStr = Files.readString(fileName);
        
        // Replace placeholders with actual data
        htmlStr = htmlStr.replace("{UserName}", userName);
        htmlStr = htmlStr.replace("{Title}", title);
        htmlStr = htmlStr.replace("{message}", body);
        
        // Render the HTML as a PDF document using IronPDF
        PdfDocument pdfDoc = PdfDocument.renderHtmlAsPdf(htmlStr);
        
        // Save the generated PDF document in the specified directory
        pdfDoc.saveAs(Paths.get("htmlTemplate/" + userName + ".pdf"));
    }
}

import com.ironsoftware.ironpdf.PdfDocument;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

public class HtmlToPdfExample {
    public static void main(String[] args) throws IOException {
        // Path to the HTML template
        Path fileName = Path.of("D:\\index.html");
        
        // Dynamic data to replace placeholders in the template
        String userName = "Mike";
        String title = "Sample PDF File";
        String body = "This is the body of our template PDF";
        
        // Read the HTML file content as a string
        String htmlStr = Files.readString(fileName);
        
        // Replace placeholders with actual data
        htmlStr = htmlStr.replace("{UserName}", userName);
        htmlStr = htmlStr.replace("{Title}", title);
        htmlStr = htmlStr.replace("{message}", body);
        
        // Render the HTML as a PDF document using IronPDF
        PdfDocument pdfDoc = PdfDocument.renderHtmlAsPdf(htmlStr);
        
        // Save the generated PDF document in the specified directory
        pdfDoc.saveAs(Paths.get("htmlTemplate/" + userName + ".pdf"));
    }
}

Powyższy kod odczytuje zawartość pliku HTML, zastępuje w nim symbole zastępcze danymi dynamicznymi, renderuje HTML jako dokument PDF przy użyciu biblioteki IronPDF i zapisuje wygenerowany dokument PDF w określonym katalogu.

Oto szczegółowe wyjaśnienie działania kodu:

1. Kod zaczyna się od utworzenia obiektu Path wskazującego na plik HTML w systemie plików lokalnych. W tym przypadku plik znajduje się w lokalizacji "D:\index.html".
2. Zadeklarowano trzy zmienne i zainicjowano je przykładowymi danymi: userName, title oraz body.
3. Zawartość pliku HTML jest wczytywana do zmiennej łańcuchowej o nazwie htmlStr za pomocą metody Files.readString.
4. Metoda String.replace służy do zastąpienia trzech placeholderów ({UserName}, {Title}, oraz {message}) w pliku HTML odpowiadającymi danymi dynamicznymi.
5. Wywoływana jest metoda [PdfDocument.renderHtmlAsPdf](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#renderHtmlAsPdf(java.lang.String) z przekazaniem zmodyfikowanego ciągu HTML jako argumentu, aby wyrenderować HTML jako dokument PDF. Wynikowy dokument PDF jest przechowywany w obiekcie PdfDocument nazwanym pdfDoc.
6. Wywoływana jest metoda pdfDoc.saveAs, aby zapisać wygenerowany dokument PDF do katalogu o nazwie "htmlTemplate" w systemie plików lokalnych, z nazwą pliku skonstruowaną z zmiennej userName.

Wynik

W ten sposób łatwo jest programowo tworzyć pliki PDF na podstawie szablonów HTML.

Możliwe jest zastąpienie tego znaku wodnego poprzez uzyskanie bezpłatnej wersji próbnej lub zakup licencji komercyjnej.

Wnioski

W tym artykułe omówiono, jak używać IronPDF for Java do generowania plików PDF. IronPDF zapewnia prosty i wydajny interfejs, który pozwala z łatwością tworzyć i edytować pliki PDF. Dzięki IronPDF można łatwo tworzyć profesjonalnie wyglądające dokumenty PDF, które można wykorzystać do różnych celów, takich jak generowanie raportów, faktur i innych rodzajów dokumentów.

IronPDF oferuje również szerokie możliwości dostosowywania, w tym opcje kontroli wyglądu i układu plików PDF. Programiści mogą określać marginesy stron, rozmiary czcionek, kolory i inne właściwości, aby tworzyć pliki PDF zgodne z ich konkretnymi wymaganiami.

Ogólnie rzecz biorąc, IronPDF to potężna i elastyczna biblioteka do generowania plików PDF w Javie. Dzięki łatwemu w obsłudze interfejsowi i szerokiej gamie funkcji IronPDF jest doskonałym wyborem dla każdej aplikacji wymagającej generowania plików PDF.

Pobierz oprogramowanie IronPDF dla Java.