Java'da PDF Dosyaları Nasıl Oluşturulur

Java İçin IronPDF Nedir ve Neden Kullanılmalıdır?

Java için IronPDF, Chromium işleme motoru üzerine kurulu bir PDF oluşturma ve manipülasyon kütüphanesidir. Chrome'un HTML'yi tam anlamıyla işlemesine dayanarak, karmaşık düzenleri, özel yazı tiplerini, CSS animasyonlarını, JavaScript ile oluşturulan içerikleri ve gömülü görüntüleri hiçbir manuel düzenleme kodu gerektirmeden işler.

Kütüphane, tek bir bağımlılık içinde tam PDF yaşam döngüsünü kapsar. Geliştiriciler belgeleri sıfırdan oluşturabilir, mevcut HTML içeriğini dönüştürebilir, dosyaları birleştirebilir veya ayırabilir, filigranlar ekleyebilir, parolalarla şifreleyebilir, metin ve resimleri çıkarabilir ve doldurulabilir formlar oluşturabilir, tümü tutarlı bir API üzerinden. HTML ağırlıklı iş akışları için, IronPDF, Apache PDFBox gibi düşük seviyeli PDF kütüphanelerinin gerektirdiği manuel sayfa düzeni hesaplamalarını ortadan kaldırır.

Çoğu ticari kullanım için AGPL açık kaynak lisansı gerektiren iText'in aksine, IronPDF ticari dostu bir lisanslama ile gelir ve karmaşık bir lisans uyumluluğu incelemesi gerektirmez. Java için IronPDF, bir Maven eseri olarak gönderilir ve Windows, Linux ve macOS üzerinde çalışır. Spring Boot, Jakarta EE ve bağımsız Java uygulamaları ile entegre olur. Kütüphane ayrıca, AWS, Azure ve Google Cloud üzerinde sunucu konuşlandırmalarını destekler.

Java'da IronPDF Kullanımı İçin Gereksinimler Nelerdir?

//: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'

Hangi İthalatlar ve Yapılandırmalar Gereklidir?

Java kaynak dosyanızın en üstüne şu ithal deyimleri ekleyin:

: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

Herhangi bir PDF oluşturmadan önce lisans anahtarınızı main metodunda veya uygulama başlangıcında ayarlayın:

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

Not: Geçerli bir lisans anahtarı olmadan, PDF'ler deneme filigranı ile üretilir. Filigranı kaldırmak için bir lisans satın alın veya ücretsiz denemenizi başlatın. Java'da lisans anahtarlarını kullanma hakkında ek yapılandırma seçenekleri için Java'da lisans anahtarlarını kullanma konusuna bakın.

Bu türden favori kütüphanem IronPDF'dir. PDF dosyalarının hızlı ve verimli bir şekilde işlenmesine olanak tanır. Ayrıca, PDF/A formatına dışa aktarma ve dijital imzalama gibi birçok değerli özelliğe sahiptir.

Milan Jovanovic

Microsoft MVP

Vaka çalışmasını görüntüle

IronOCR, manuel işleme maliyetinden yıllık 40.000 USD tasarruf etmemizi sağlıyor, üretkenliği artırıyor ve yüksek etkili görevler için kaynakları serbest bırakıyor. Kesinlikle tavsiye ederim.

Brent Matzelle

Teknoloji Müdürü, OPYN

Vaka çalışmasını görüntüle

IronSuite, operasyonlarımızda kritik bir rol oynar. Bunlar, iş süreçlerinde verimliliği artıran, kat planları oluşturmak ve envanter yönetimini geliştirmek gibi araçlardır.

David Jones

Baş Yazılım Mühendisi, Agorus Build

Vaka çalışmasını görüntüle

Java'da Bir HTML Dizesinden PDF Nasıl Oluşturulur?

Herhangi bir HTML dizgisini doğrudan PdfDocument.renderHtmlAsPdf() öğesine iletin. IronPDF, bellekte tamamlanmış belgeyi temsil eden PdfDocument örneğini döndürür. Diskine yazmak için saveAs() çağrısını yapın.

: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(), web yazı tipleri, Flexbox, Grid düzenleri ve JavaScript yürütmesi dahil olmak üzere tam HTML5 ve CSS3 spesifikasyonunu destekler. Aşağıdaki örnek, özel stillere sahip çok satırlı bir HTML şablonu kullanır:

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

Yukarıdaki fatura örneği, Java 13'ten beri mevcut olan Java metin bloklarını, daha temiz çok satırlı HTML için kullanır. Eski Java sürümleri için, HTML dizgisini elle birleştirin veya renderHtmlFileAsPdf() kullanarak bir dosyadan yükleyin. JavaScript işleme de dahil olmak üzere HTML'den PDF'ye dönüşüm hakkında daha geniş bir bakış için, HTML to PDF kılavuzuna bakın.

Java'da Yerel Bir HTML Dosyasından PDF Nasıl Oluşturulur?

Yerel dosya sisteminde saklanan bir HTML dosyasını dönüştürmek için PdfDocument.renderHtmlFileAsPdf() kullanın. Yolu bir dize olarak geçirin; göreli yollar, mevcut çalışma dizinine göre çözülür:

: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, tüm referans varlıkları (dış CSS dosyaları, yerel görüntüler ve JavaScript kütüphaneleri) HTML dosyasının dizinine göre çözer. Bu, bağlantılı stil sayfalarına sahip eksiksiz bir HTML şablonu oluşturup, hiçbir varlık yolunu değiştirmeden IronPDF'den geçirebileceğiniz anlamına gelir.

Bu metot hem bir String yolu hem de java.nio.file.Path nesnesini kabul eder. Çalışma dizini belirsizliğinden kaçınmak için üretimde mutlak yolları tercih edin. Dosyadan PDF'ye örneği tamamı çalışan bir gösterim için inceleyin.

Java'da Bir Web Sayfası URL'sinden PDF Nasıl Oluşturulur?

PdfDocument.renderUrlAsPdf() canlı bir URL'yi alır, Chromium kullanarak render eder ve bir PDF döndürür. Gösterge tablolarının anlık görüntülerini yakalamak, barındırılan makbuz sayfalarından PDF makbuzları oluşturmak veya web içeriğini arşivlemek için bu kullanışlıdır:

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

HTTP kimlik doğrulaması arkasındaki sayfalar için, kimlik bilgilerini ChromePdfRenderOptions üzerinden iletin:

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

URL'den PDF'ye kod örneği ayrıntılar için inceleyin. Çerezler veya form tabanlı kimlik doğrulama kullanan daha karmaşık giriş akışları için web sitesi giriş işlemleri sayfasını inceleyin.

Sayfa Boyutunu, Yönünü ve Kenar Boşluklarını Nasıl Kontrol Ederim?

Çıktı PDF'sinin fiziksel düzenini özelleştirmek için ChromePdfRenderOptions kullanın. Yapılandırılmış seçenekleri, herhangi bir işleme yönteminin ikinci argümanı olarak iletin. En yaygın ayarlar sayfa yönü, kağıt boyutu ve kenar boşluklarıdır:

: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, yukarıda gösterilenlerin ötesinde DPI, JavaScript yürütme zaman aşımı, yakınlaştırma faktörü ve CSS medya türü dahil olmak üzere 30'dan fazla ayar sunar. Tam liste için PDF oluşturma ayarlarına bakın. PaperSize enumunda olmayan özel kağıt boyutları için özel PDF kağıt boyutlarına bakın.

Java'da Bir PDF'ye Şifre Koruması Nasıl Eklenir?

SecurityOptions, okuma ve sahip parola ile izin bayraklarını kontrol eder. Belgenin SecurityManager kısmına kaydetmeden önce SecurityOptions iletin:

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

Daha sıkı bir kontrol için, bir sahip parolası ayarlayın ve belirli işlemleri kısıtlayın:

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

PDF'yi açmak okuyucuyu bir parola istemi ile uyarır:

PDF okuyucuları bir kullanıcı parolası ile korunmuş bir belge olduğunda parola istemini görüntüler.

Doğru parola girildikten sonra PDF açılır ve tam içeriği görüntüler:

Belge, doğru parola sağlandıktan sonra normal bir şekilde görüntülenir.

Yetki bayraklarının tam listesi için güvenlik ve meta veri ayarları sayfasını inceleyin.

Spring Boot Uygulamasında PDF Nasıl Oluşturulur?

IronPDF, Spring Boot ile doğrudan entegre edilir. Herhangi bir kontrolörü yönteminden bir bayt dizi HTTP yanıtı olarak bir PDF döndürün; bu model, isteğe bağlı rapor oluşturma, fatura indirmeleri ve veri dışa aktarımları için çalışır.

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

getBinaryData() yöntemi, Spring Boot'un doğrudan müşteriye akışı için PDF'yi bayt dizisi olarak döndürür. Disk'e geçici bir dosya yazılmamaktadır. Yüksek verimli dağıtımlar için, License.setLicenseKey() örneğini bir @PostConstruct metodunda veya uygulama başlangıç dinleyicisinde oluşturun, her istek için değil.

Java PDF Oluşturmak İçin Sonraki Adımlar Nelerdir?

Bu kılavuz, IronPDF kullanarak Java'da PDF oluşturma için dört yaklaşımı gösterdi: HTML dizesi işleme, yerel dosya dönüştürme, URL yakalama ve Spring Boot HTTP yanıt akışı. Tüm metodlar aynı PdfDocument API'sini, biçimlendirme kontrolü için ChromePdfRenderOptions ve erişim koruması için SecurityOptions paylaşır.

Java için IronPDF ayrıca filigran ekleme ve damgalama, birden fazla PDF dosyasını birleştirme, PDF'leri bireysel sayfalara bölme, dijital imzalar ekleme, JavaScript grafikleri PDF olarak işleme ve programatik olarak PDF yazdırma seçeneklerini destekler.

Filigransız PDF oluşturmak için ücretsiz denemeye başlayın veya projelerinize uygun bir plan seçmek için lisanslama seçeneklerini görüntüleyin. Daha derine inmeye hazır mısınız? Java için IronPDF eğitim sayfasının tamamını inceleyin.