Jak utworzyć plik PDF z szablonu w Javie

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 następującą zależność do pliku pom.xml projektu:

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>VERSION_NUMBER</version> 
</dependency>

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>VERSION_NUMBER</version> 
</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 wczytania 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 nazwiskami uczniów.
2. Pętla for iteruje przez każdą nazwę w tablicy studentNames.
3. Metoda PdfDocument.fromFile ł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 imieniem i nazwiskiem aktualnego ucznia.
5. Metoda PdfDocument.saveAs zapisuje zmodyfikowany plik PDF z imieniem i nazwiskiem ucznia jako nazwą 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.

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 rozpoczyna się od utworzenia obiektu Path, który wskazuje na plik HTML w lokalnym systemie plików. 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 typu string o nazwie htmlStr przy użyciu metody Files.readString.
4. Metoda String.replace służy do zastąpienia trzech symboli zastępczych ({UserName}, {Title} i {message}) w pliku HTML odpowiednimi danymi dynamicznymi.
5. Metoda PdfDocument.renderHtmlAsPdf jest wywoływana z zmodyfikowanym ciągiem HTML jako argumentem w celu renderowania kodu HTML jako dokumentu PDF. Powstały dokument PDF jest przechowywany w obiekcie PdfDocument o nazwie pdfDoc.
6. Wywoływana jest metoda pdfDoc.saveAs w celu zapisania wygenerowanego dokumentu PDF w katalogu o nazwie "htmlTemplate" w lokalnym systemie plików, przy czym nazwa pliku jest tworzona na podstawie 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 artykule 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 for Java.