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

IronPDF

IronPDF, Iron Software tarafından oluşturulmuş ve sürdürülen bir Java kütüphanesidir. PDF oluşturmanın birçok karmaşıklığını soyutlayan, kullanıcı dostu bir arayüz sunar ve geliştiricilerin PDF'lerinin içeriğine odaklanmasına, dosyaların nasıl oluşturulduğunun detaylarına değil. IronPDF ayrıca, PDF şablonları ile çalışma, doldurulabilir formlar ve dijital imzalar için birçok özellik sunar.

Bu eğitici, IronPDF'i Java'da kullanarak bir şablondan PDF dosyası oluşturmak için gereken adımlarını öğrenmenizi sağlayacak.

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

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

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

1. IntelliJ IDEA'yı açın ve karşılama ekranından veya "File" menüsünden "Create New Project" seçeneğini seçin.
2. Sol menüden "Java" seçeneğini ve projeniz için kullanmak istediğiniz JDK sürümünü seçin. "İleri"ye tıklayın.
3. Proje adını ve konumunu belirleyin, ve proje türünü seçin. Java Uygulaması, Java Kütüphanesi veya JavaFX Uygulaması gibi birçok farklı proje türü 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ı belirtebilirsiniz. Ayrıca bir modül oluşturmayı veya 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 kodu olan bir proje oluşturmayı veya mevcut bir projeyi içe aktarmayı seçebilirsiniz. "Finish" üzerine tıklayın.

IntelliJ IDEA Kullanarak Yeni Java Projesi Oluşturun

2. Adım: IronPDF Kütüphanesini Projenize Ekleyin

İkinci adım, IronPDF kütüphanesini bir XML dosyası kullanarak Java projenize 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>

3. Adım: PDF Şablonunu Oluşturun

Bir sonraki adım, PDF dosyanızı oluşturmak için kullanacağınız bir PDF şablonu oluşturmaktır. Herhangi bir PDF düzenleyicisi kullanarak PDF şablonunuzu oluşturabilirsiniz. Şablon, çalışma anında dinamik verilerle değiştirilecek yer tutucuları içerebilir.

Diyelim ki, 50 öğrenciye bir grup sertifika dağıtılıyor. Şimdi, her kullanıcı için ayrı sertifika oluşturmak oldukça zahmetli bir iştir. Bu yüzden bir şablon kullanılır ve aşağıda gösterilen demo programı ile sadece bir isim değiştiririz.

Sertifika Şablon Resmi Örneği

4. Adım: Ş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. IronPDF kullanarak bir PDF şablonunu nasıl yükleyeceğinizi gösteren bir örnek kod parçası.

// 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ğıda, çıktı günlükleri verilmiştir:

Çıktı

Yukarıdaki kod, bir öğrenci adları dizisi oluşturur ve ardından mevcut bir PDF şablonundaki yer tutucu metni her öğrencinin adıyla değiştirir, ardından öğrencinin adını dosya adı olarak kullanarak yeni bir PDF kopyası kaydeder.

İşte kodun çalışma şekli:

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

Bu şekilde, tek bir PDF şablonuna dayalı olarak, her biri benzersiz bir öğrenci adı olan birden çok sertifika oluşturulur. Aynı yaklaşım, herhangi bir şablonla PDF belgeleri oluşturmak için de kullanılabilir.

Sertifika Çıktı Dosyası

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

Sertifika Çıktısı

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

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

Örnekte gösterilmek üzere HTML dosyası.

HTML Çıktısı

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 dizine kaydeder.

İşte kodun ne yaptığını adım adım açıklaması:

1. Kod, yerel dosya sistemindeki bir HTML dosyasını işaret eden bir Path nesnesi oluşturarak başlar. Bu durumda, dosya 'D:\index.html' konumunda yer almaktadır.
2. userName, title ve body adlı üç değişken ilan edilir ve örnek veri ile 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. String.replace yöntemi, HTML dosyasındaki üç yer tutucuyu ({UserName}, {Title} ve {message}) ilgili dinamik verilerle değiştirmek için kullanılır.
5. Değiştirilmiş HTML dizesi bir argüman olarak verilerek, HTML'yi bir PDF belge olarak işlemek için [PdfDocument.renderHtmlAsPdf](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#renderHtmlAsPdf(java.lang.String) yöntemi çağrılır. Ortaya çıkan PDF belgesi, pdfDoc adlı bir PdfDocument nesnesinde depolanır.
6. Oluşturulan PDF belgesini yerel dosya sisteminde "htmlTemplate" adlı bir dizine kaydetmek için pdfDoc.saveAs yöntemi çağrılır ve dosya adı userName değişkeninden oluşturulur.

Çıktı

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

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

Sonuç

Bu makale, Java için IronPDF kullanarak PDF dosyalarının nasıl üretileceğini araştırdı. IronPDF, PDF dosyalarını oluşturmayı ve manipüle etmeyi sağlayan basit ve güçlü bir arayüz sunar. IronPDF ile, raporlar, faturalar ve diğer türde belgeler oluşturma gibi çeşitli amaçlar için kullanılabilecek profesyonel görünümlü PDF belgelerini kolaylıkla oluşturabilirsiniz.

IronPDF ayrıca PDF dosyalarının görünümünü ve düzenini kontrol etme seçenekleriyle son derece özelleştirilebilir. Geliştiriciler, sayfa kenar boşlukları, yazı tipi boyutları, renkler ve diğer özellikleri belirleyerek belirli gereksinimlerine uygun PDF dosyaları oluşturabilirler.

Genel olarak, IronPDF, Java'da PDF üretimi için güçlü ve esnek bir kütüphanedir. Kullanımı kolay arayüzü ve geniş özellik yelpazesi ile IronPDF, PDF üretimi gerektiren herhangi bir uygulama için mükemmel bir seçimdir.

Java için IronPDF, yazılım ürünü.