Java'da Şablondan PDF Oluşturma Yöntemi

IronPDF

IronPDF, Iron Software tarafından geliştirilen ve bakım yapılan bir Java kütüphanesidir. PDF oluşturmanın birçok karmaşıklığını ortadan kaldıran, geliştiricilerin PDF'lerinin içeriğine odaklanmasını sağlayan kullanımı kolay bir arayüz sunar. IronPDF ayrıca PDF şablonları, doldurulabilir formlar ve dijital imzalar ile çalışmayı kolaylaştıran bir dizi özellik sunar.

Bu eğitim, Java'da IronPDF kullanarak şablondan bir PDF dosyası oluşturmak için gereken adımlarda sizi yönlendirecektir.

İlk adım bir proje oluşturmaktır.

Adım 1: Yeni bir Java projesi oluşturun

IntelliJ IDEA kullanarak yeni bir Java projesi oluşturmanın adımları şunlardır:

1. IntelliJ IDEA'yı açın ve hoş geldiniz ekranından veya "Dosya" menüsünden "Yeni Proje Oluştur"'u seçin.
2. Sol menüden "Java"yı seçin ve proje için kullanmak istediğiniz JDK sürümünü belirleyin. "İleri"ye tıklayın.
3. Projeniz için bir proje adı ve konum seçin ve proje türünü belirleyin. Java Uygulaması, Java Kütüphanesi veya JavaFX Uygulaması gibi farklı proje türlerinden birini seçebilirsiniz. "İleri"ye tıklayın.
4. Proje ayarlarını yapılandırın. Proje SDK'sını, proje dil seviyesini ve diğer ayarları belirleyebilirsiniz. Bir modül oluşturmayı ya da mevcut bir modül seçmeyi de tercih edebilirsiniz. "İleri"ye tıklayın.
5. Proje şablonunu seçin. Boş bir proje oluşturmayı, örnek kod içeren bir proje oluşturmayı veya mevcut bir projeyi içe aktarmayı tercih edebilirsiniz. "Bitir"e tıklayın.

IntelliJ IDEA Kullanarak Yeni Java Projesi Oluşturun

Adım 2: Projenize IronPDF Kütüphanesi Ekleyin

İkinci adım, bir XML dosyası kullanarak Java projenize IronPDF kutuphanesi eklemektir. Bunu, projenizin pom.xml dosyasına aşağıdaki bağımlılığı ekleyerek yapabilirsiniz:

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

Adım 3: PDF Şablonunu Oluşturun

Sonraki adım, PDF dosyanızı oluşturmak için kullanacağınız bir PDF şablonu oluşturmaktır. PDF şablonuzu herhangi bir PDF editörü kullanarak oluşturabilirsiniz. Şablon, dinamik verilerle çalışma zamanında değiştirilecek olan yer tutucuları içerebilir.

50 öğrenciye bir dizi sertifika verilmesi gerektiğini varsayın. Şimdi her kullanıcı için ayrı sertifikalar oluşturmak oldukça yorucu bir görev. Bu nedenle, aşağıda gösterilen bu demo programla olduğu gibi sadece bir isim değiştirerek bir şablon kullanılır.

Sertifika Şablonu görüntü örneği

Adım 4: Şablondan PDF Belgeleri Oluşturun

PDF şablon sertifikasını oluşturduktan sonra ilk adım onu Java uygulamasına yüklemektir. IronPDF PdfDocument sınıfı, PDF şablonunu belleğe yüklemek için kullanılır. İşte IronPDF kullanarak bir PDF şablonunu nasıl yükleyeceğinizi gösteren bir kod parçacığı örneği:

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

Şimdi, verilen şablona dayalı olarak 5 sertifika oluşturacak bir kod örneği yazalım.

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

Aşağıdakiler çıktı günlükleridir:

Çıktı

Yukarıdaki kod, öğrenci adlarını içeren bir dizi oluşturur ve ardından mevcut bir PDF şablonundaki yer tutucu metni her bir öğrenci adıyla değiştirmek için IronPDF kütüphanesini kullanır ve ardından öğrencinin adını dosya adı olarak kullanarak yeni bir PDF kopyası kaydeder.

İşte kodun nasıl çalıştığı:

1. studentNames dizisi tanımlanır ve beş öğrenci ismiyle başlatılır.
2. for döngüsü, studentNames dizisindeki her ismi iterasyonla işler.
3. PDF şablon dosyasını "CERTIFICATE.pdf" adlı bir PdfDocument nesnesine yüklemek için [PdfDocument.fromFile](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#fromFile(java.nio.file.Path) yöntemi kullanılır.
4. PdfDocument.replaceText yöntemi, PDF şablonundaki "Alıcı İsmi" metnini mevcut öğrencinin ismiyle değiştirmek için kullanılır. [PdfDocument.saveAs](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#saveAs(java.lang.String) yöntemi, düzenlenmiş PDF dosyasını öğrencinin ismiyle "Certificate" dizinine kaydeder.
5. Döngü, tüm öğrenci adları işlenene kadar devam eder.

Bu şekilde, her biri benzersiz bir öğrenci adı içeren çoklu sertifikalar, tek bir PDF şablonunu temel alarak oluşturulur. Aynı yaklaşım herhangi bir şablonla PDF belgeleri üretmek için kullanılabilir.

Sertifika Çıktı Dosyası

Bu demo program tarafından üretilen sertifika aşağıdadır.

Sertifika Çıktısı

Adım 5: HTML Şablonundan PDF Şablonu Oluşturma

Bu örnekte, bir PDF şablonu oluşturmak için HTML dosyası kullanılacak ve ardından bu şablon bir PDF belgesi üretmek için kullanılacaktır.

Bu, örnekte gösterim için kullanılan HTML dosyasıdır.

HTML Çıkışı

Verilen HTML formatından yeni bir belge oluşturmak için aşağıdaki kod örneğini düşünün.

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

Yukarıdaki kod, bir HTML dosyasının içeriğini okur, HTML dosyasındaki yer tutucuları dinamik verilerle değiştirir, HTML'yi IronPDF kütüphanesini kullanarak bir PDF belgesi olarak işler ve oluşturulan PDF belgesini belirli bir dizinde kaydeder.

İşte kodun adım adım açıklaması:

1. Kod, yerel dosya sisteminde bir HTML dosyasına işaret eden bir Path nesnesi oluşturarak başlar. Bu durumda, dosya "D:\index.html" konumundadır.
2. userName, title ve body adında üç değişken tanımlanır ve bazı örnek verilerle başlatılır.
3. HTML dosyasının içeriği, Files.readString yöntemi kullanılarak htmlStr adlı bir string değişkenine okunur.
4. HTML dosyasındaki üç yer tutucuyu ({UserName}, {Title} ve {message}) karşılık gelen dinamik verilerle değiştirmek için String.replace yöntemi kullanılır. [PdfDocument.renderHtmlAsPdf](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#renderHtmlAsPdf(java.lang.String) yöntemi, HTML'yi bir PDF belgesi olarak render etmek için değiştirilmiş HTML dizesini bir argüman olarak çağırır. Oluşan PDF belgesi, pdfDoc adlı bir PdfDocument nesnesinde saklanır.
5. pdfDoc.saveAs yöntemi, oluşturulan PDF belgesini, dosya adının userName değişkeninden oluşturulmasıyla yerel dosya sisteminde "htmlTemplate" adlı bir dizine kaydetmek için çağırılır.

Çıktı

Bu şekilde, HTML şablonlarından programatik olarak PDF dosyaları oluşturmak kolaydır.

Bu filigranı ücretsiz bir deneme alarak veya ticari bir lisans satın alarak değiştirmek mümkündür.

Sonuç

Bu makale, Java'daki PDF dosyalarını oluşturmada IronPDF kullanımını araştırdı. IronPDF, PDF dosyaları oluşturmayı ve düzenlemeyi kolaylaştıran basit ve güçlü bir arayüz sunar. IronPDF ile, çeşitli amaçlar için kullanılabilecek, profesyonel görünen PDF belgelerini kolayca oluşturabilirsiniz; raporlar, faturalar ve diğer belge türleri gibi.

IronPDF ayrıca, PDF dosyalarının görünümünü ve düzenini kontrol etme seçenekleri ile oldukça özelleştirilebilir. Geliştiriciler, belirli gereksinimlerini karşılayan PDF dosyaları oluşturmak için sayfa kenar boşluklarını, yazı tipi boyutlarını, renklerini ve diğer özellikleri belirleyebilir.

Genel olarak, IronPDF, Java'da PDF oluşturma için güçlü ve esnek bir kutuphanedir. Kullanımı kolay arayüzü ve çok çeşitli özellikleri ile IronPDF, PDF oluşturma gerektiren herhangi bir uygulama için harika bir seçimdir.

IronPDF for Java, yazılım ürününü indirin.