Java ile HTML'den PDF'e

IronPDF'i Maven Projesine Nasıl Eklerim?

Bir Maven projesine IronPDF eklemek, projenin pom.xml bağımlılık bloğunda iki giriş gerektirir. İlk giriş, IronPDF kütüphanesini çeker; ikincisi, IronPDF'in çalıştırma sırasında motor mesajlarını yazabilmesi için bir SLF4J kayıt sağlayıcısı ekler.

//:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/maven-dependency.xml
<dependency>
  <groupId>com.ironsoftware</groupId>
  <artifactId>ironpdf</artifactId>
  <version>2024.9.1</version>
</dependency>
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-simple</artifactId>
  <version>2.0.5</version>
</dependency>

//:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/maven-dependency.xml
<dependency>
  <groupId>com.ironsoftware</groupId>
  <artifactId>ironpdf</artifactId>
  <version>2024.9.1</version>
</dependency>
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-simple</artifactId>
  <version>2.0.5</version>
</dependency>

ironpdf eserin en son IronPDF for Java sürümü ve değişiklik günlüğü referansları. slf4j-simple bağımlılığı temel bir günlük kaydı arka planı sağlar. Logback veya Log4J ile gerektiğinde değiştirebilir ya da log çıkışını kapatmak için tamamen çıkarabilirsiniz.

Her iki girişi ekledikten sonra, eserleri indirmek için proje kökünden mvn install çalıştırın. Maven, bağımlılığı Maven Central ile çözer.

IronPDF JAR'ını Manuel Olarak Java'ya Nasıl Kurarım?

Maven veya başka bir bağımlılık yöneticisi kullanmayan projeler, JAR'ı doğrudan indirip ve sınıf yoluna ekleyerek IronPDF'i ekleyebilir. IronPDF for Java indirme sayfasına gidin ve fat-JAR dosyasını indirin.

Fat-JAR, tüm bağımlılıkları paketler, bu yüzden ana artifact dışında ek sınıf yolu girişleri gerekmez. Kayıt işlemlerini etkinleştirmek için isteğe bağlı olarak bir SLF4J uygulama JAR'ı indirin.

Her iki JAR dosyasını IDE'nizin kütüphane yönetim panelini kullanarak projenin classpath'ine ekleyin veya terminalden derleme ve çalıştırma sırasında -classpath girişleri belirtin.

IronPDF'i Java Kaynak Dosyalarıma Nasıl İçe Aktarırım?

com.ironsoftware.ironpdf paketi tüm dönüşüm ve işleme bileşenlerini içerir. IronPDF yöntemlerini çağıran her Java dosyasının en üstüne aşağıdaki import ifadesini ekleyin.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/import-statement.java

// Import all IronPDF components
import com.ironsoftware.ironpdf.*;

Belirli sınıfları adlandıran hedeflenmiş bir içe aktarma da geçerlidir: import com.ironsoftware.ironpdf.PdfDocument;. Keşif sırasında joker karakterli import kullanışlıdır.

IronPDF için Java'da Lisans Anahtarı Nasıl Ayarlanır?

IronPDF for Java, lisans anahtarı olmadan ücretsiz kullanılabilir, ancak tüm oluşturulan veya değiştirilmiş PDF belgelerine döşeme şeklinde bir filigran uygular. Filigranı kaldırmak için, herhangi bir dönüştürme veya manipülasyon yöntemini çağırmadan önce geçerli bir lisans anahtarı sağlayın.

//:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/set-license-key.java
// Set the license key before any PDF operations
License.setLicenseKey("YOUR-LICENSE-KEY");

//:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/set-license-key.java
// Set the license key before any PDF operations
License.setLicenseKey("YOUR-LICENSE-KEY");

Uygulama başlangıcında, herhangi bir PdfDocument yöntemi çağrılmadan önce setLicenseKey çağrısını yerleştirin. Lisans anahtarı satın alın veya ücretsiz deneme başlatın ve filigransız PDF'ler oluşturun.

Geçerli bir lisans anahtarı, oluşturulan PDF'lerden döşenmiş filigranı kaldırır. IronPDF lisanslama sayfasında bir tane edinin veya ücretsiz bir deneme talep edin.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/set-log-path.java

import java.nio.file.Paths;
// Redirect log output before using IronPDF
Settings.setLogPath(Paths.get("logs/ironpdf-engine.log"));

HTML Dizesini Java'da PDF'ye Nasıl Dönüştürürüm?

PdfDocument.renderHtmlAsPdf(String html) geçerli herhangi bir HTML işaretlemesini bir PDF belgesine dönüştürür. Yöntem, ham bir HTML dizesi alır ve kaydedilebilen, birleştirilebilen veya daha da özelleştirilebilen bir PdfDocument nesnesi döndürür.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/html-string-to-pdf.java

// Convert a minimal HTML string to a PDF document
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from IronPDF!</h1>");
// Save the resulting document to disk
pdf.saveAs("html-string-output.pdf");

IronPDF, HTML biçimlendirmesini doğrudan piksel hassasiyetinde bir PDF'ye işliyor. Burada gösterilen çıktı, yukarıdaki kod örneği tarafından üretilmiştir.

İşleme motoru Chromium tabanlıdır, bu nedenle Chrome'da çalışan herhangi bir HTML, CSS veya JavaScript, PDF'de doğru şekilde işlenir. Bu, Flexbox düzenleri, CSS Grid, web yazı tipleri, SVG'ler ve JavaScript tabanlı grafikler içerir.

Yöntemin aşırı yüklenmiş bir versiyonu, ikinci bir taban yolu argümanını kabul eder: renderHtmlAsPdf(String html, String basePath). Bu temel yol, yerel stil dosyalarına, görüntülere ve betiklere göreli referansları çözmek için kullanılır.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/html-string-with-assets.java

// HTML referencing local stylesheet and image
String html = "<html><head><link rel='stylesheet' href='style.css'></head>"
    + "<body><img src='logo.png'/><h1>Invoice</h1></body></html>";
// Provide the folder containing style.css and logo.png as the base path
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html, "C:/invoices/");
pdf.saveAs("invoice-output.pdf");

Temel yol, yerel dosya sistemindeki bir dizine veya uzaktaki bir URL'ye işaret edebilir. IronPDF, işleme sırasında referans alınan varlıkları o konumdan alır.

Temel bir yol sağlandığında, IronPDF, tam anlamıyla stil sahibi bir PDF üretmek için yerel CSS ve görüntü referanslarını çözer.

Bu yöntemin odaklanmış bir görünümü için HTML dizesini PDF oluşturmak için kod örneğine bakın.

URL'yi Java'da PDF'ye Nasıl Dönüştürürüm?

PdfDocument.renderUrlAsPdf(String url) verilen URL'deki sayfayı alır ve çıktıyı PDF olarak kaydetmeden önce tam DOM'u (JavaScript yürütmesi dahil) işler.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/url-to-pdf.java

// Render a live web page to PDF by URL
PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://en.wikipedia.org/wiki/PDF");
// Save the rendered document
pdf.saveAs("wikipedia-pdf-article.pdf");

IronPDF, bir web sayfasının tam işlenmiş durumunu, JavaScript tarafından üretilen dinamik içerik dahil, yakalar.

Chromium işleme motoru, dış stil dosyalarını, yazı tiplerini ve JavaScript dosyalarını alır; bunun sonucunda oluşan PDF, sayfanın görsel durumunu doğru bir şekilde yansıtır. Bu yöntem, web panolarından rapor oluşturma, halka açık web içeriğini arşivleme veya istemci tarafı işleme dayalı veri görselleştirmelerini dönüştürme için uygundur.

Özel istek başlıkları ve kimlik doğrulama gibi ek seçenekler için URL'den PDF'ye dönüştürme örneğine bakın.

HTML Dosyasını Java'da PDF'ye Nasıl Dönüştürürüm?

PdfDocument.renderHtmlFileAsPdf(String filePath) yerel dosya sisteminden bir HTML dosyası okur ve bunu PDF'ye dönüştürür. Yöntem, HTML dosyasındaki her türlü göreli varlık referansını dosyanın dizinine göre otomatik olarak çözer.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/html-file-to-pdf.java

// Convert a local HTML file (with a linked CSS file) to PDF
PdfDocument pdf = PdfDocument.renderHtmlFileAsPdf("C:/invoices/TestInvoice1.html");
// Save the resulting document
pdf.saveAs("invoice-from-file.pdf");

Yöntem, çok dosyalı HTML projelerini doğru bir şekilde işler. Yukarıdaki örnekte, TestInvoice1.html aynı dizindeki bir stile bağlanıyorsa, IronPDF, işleme sırasında o stili uygular. Sonuç, kaynak dosyanın tarayıcıda gösterilen görünümüne uygun bir PDF'dir.

@

Bu yöntem, disk üzerinde HTML şablonlarını koruyan PDF oluşturma iş akışları için özellikle yararlıdır: fatura üreteçleri, rapor şablonları ve form çıktı sistemleri yaygın kullanım alanlarıdır.

Java'da PDF Sayfa Boyutu ve Yönlendirmesini Nasıl Ayarlarım?

Sayfa boyutu ve yönlendirme ChromePdfRenderOptions sınıfı aracılığıyla kontrol edilir. Bir ChromePdfRenderOptions örneği oluşturun, özellikleri yapılandırın ve herhangi bir renderHtmlAsPdf çağrısına ikinci argüman olarak gönderin.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/page-size-orientation.java

import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.render.*;
// Create rendering options for the PDF
ChromePdfRenderOptions options = new ChromePdfRenderOptions();
// Set paper size to A4
options.setPaperSize(PaperSize.A4);
// Set to landscape orientation
options.setPaperOrientation(PaperOrientation.Landscape);
// Apply options to the conversion
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Landscape Report</h1>", options);
pdf.saveAs("landscape-a4-report.pdf");

PaperSize A4, Letter, Legal, A3 ve A5 gibi standart seçenekleri içerir. PaperOrientation Portrait (varsayılan) veya Landscape kabul eder.

Standart olmayan boyutlar için setCustomPaperSizeInMillimeters(double width, double height) veya setCustomPaperSizeInInches(double width, double height) kullanın:

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/custom-paper-size.java

ChromePdfRenderOptions options = new ChromePdfRenderOptions();
// Set a custom 100mm x 150mm page size
options.setCustomPaperSizeInMillimeters(100, 150);
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<p>Custom size card</p>", options);
pdf.saveAs("custom-size-card.pdf");

özel PDF kağıt boyutu örneği PaperSize sabitleri ve boyutlandırma seçeneklerinin tam listesi için bakın.

Java'da PDF'ye Özel Kenar Boşlukları Nasıl Belirlerim?

Kenar boşlukları boyutları da ChromePdfRenderOptions üzerinden ayarlanır. Kütüphane, milimetre cinsinden değerleri kabul eden üst, alt, sol ve sağ kenar boşlukları için ayrı ayarları sunar.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/custom-margins.java

ChromePdfRenderOptions options = new ChromePdfRenderOptions();
// Set all four margins in millimeters
options.setMarginTop(20);
options.setMarginBottom(20);
options.setMarginLeft(15);
options.setMarginRight(15);
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(
    "<p>Document with custom margins</p>", options);
pdf.saveAs("custom-margins.pdf");

Tüm kenar boşluklarını sıfıra ayarlamak, etiketler, sertifikalar veya grafik düzenleri gibi tam sayfa tasarımları için kullanışlı olan beyaz alanı tamamen kaldırır.

Özel kenar boşlukları örneği için çalışan bir kod örneği inceleyin.

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 PDF'ye Başlıklar ve Altbilgiler Nasıl Eklerim?

IronPDF, iki tür başlık ve altbilgi destekler: metin tabanlı (TextHeaderFooter) ve HTML tabanlı (HtmlHeaderFooter). Metin başlıklar hızlıca yapılandırılır; HTML başlıklar tam stil ve görüntü desteği sunar.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/text-header-footer.java

import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.headerfooter.*;
import com.ironsoftware.ironpdf.render.*;
ChromePdfRenderOptions options = new ChromePdfRenderOptions();
// Configure a text-based header
TextHeaderFooter header = new TextHeaderFooter();
// Use merge fields: {page}, {total-pages}, {date}, {time}, {url}, {html-title}
header.setCenterText("Report Title");
header.setRightText("Page {page} of {total-pages}");
options.setTextHeader(header);
// Configure a text-based footer
TextHeaderFooter footer = new TextHeaderFooter();
footer.setLeftText("Confidential");
footer.setCenterText("{date}");
options.setTextFooter(footer);
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(
    "<h1>Annual Report</h1><p>Content here.</p>", options);
pdf.saveAs("report-with-headers.pdf");

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/html-header.java

import com.ironsoftware.ironpdf.headerfooter.*;
HtmlHeaderFooter header = new HtmlHeaderFooter();
header.setHtmlFragment(
    "<div style='background:#003366;color:white;padding:8px;font-family:Arial;'>"
    + "<img src='/images/logo.png' style='height:30px;float:left;'/>"
    + "<span style='line-height:30px;margin-left:10px;'>Company Report</span>"
    + "</div>"
);
ChromePdfRenderOptions options = new ChromePdfRenderOptions();
options.setHtmlHeader(header);
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(
    "<h1>Q3 Results</h1>", options);
pdf.saveAs("report-with-html-header.pdf");

Java'da PDF'ye Filigran Nasıl Uygularım?

IronPDF, mevcut PDF sayfalarına HTML içeriği etkilenmeden ekleyerek filigranlar uygular. Bu yaklaşım, konum, saydamlık ve stil üzerinde tam kontrol sağlar.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/watermark.java

import com.ironsoftware.ironpdf.*;
// Create the base PDF
PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Confidential Report</h1>");
// Apply a diagonal text watermark using HTML stamping
String watermarkHtml =
    "<div style='position:absolute;top:50%;left:50%;transform:translate(-50%,-50%) rotate(-45deg);"
    + "font-size:80px;color:rgba(200,0,0,0.15);font-family:Arial;font-weight:bold;"
    + "white-space:nowrap;pointer-events:none;'>CONFIDENTIAL</div>";
pdf.applyStamp(watermarkHtml);
pdf.saveAs("watermarked-report.pdf");

applyStamp yöntemi, standart HTML/CSS kabul eder. Metin için yarı saydam bir rgba rengi kullanmak, filigranın altındaki belge içeriğini örtmeden görünmesini sağlar.

Görüntü tabanlı filigranlar veya belirli sayfa aralıklarına uygulanan filigranlar için bkz: Java için özel filigran rehberi.

Java'da Bir PDF Dosyası Nasıl Sıkıştırılır?

Görüntü içeren PDF dosyalarında, IronPDF, gömülü görüntüleri daha düşük çözünürlüklere örnekleyerek dosya boyutunu azaltabilir. Mevcut bir PdfDocument üzerinde compressImages kullanın.

:path=/static-assets/pdf/content-code-examples/tutorials/format-pdfs/compress-pdf.java

// Load an existing PDF or use one created by IronPDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("large-report.pdf"));
// Reduce image quality to 60% (value range: 1–100)
pdf.compressImages(60);
// Save the compressed document
pdf.saveAs("compressed-report.pdf");

Kalite parametresi 1 ile 100 arasında bir tam sayı olup, 100 tam görüntü kalitesini muhafaza eder ve düşük değerler görüntü sadakatinden ödün vererek dosya boyutunu azaltır. 60 ile 80 arasında bir değer, çoğu iş belgesi için boyut ve görsel kalite arasında pratik bir denge sağlar.

Görüntü kalitesi eşiklerine dair daha fazla bilgi için PDF sıkıştırma örneğine bakın.

Sonraki Adımlar

Bu eğitimde, sayfa boyutu ayarlama, kenar boşlukları, başlıklar, altbilgiler, filigranlar ve sıkıştırmanın yanı sıra üç HTML'den PDF'ye dönüştürme yöntemi (dize, URL ve dosya) yer aldı. Bunlar, Java sunucu uygulamaları için en yaygın PDF biçimlendirme işlemleridir.

Java için IronPDF ile daha ileriye gitmek için:

• IronPDF for Java için tam kod örneklerini keşfedin başlangıç noktaları için kopyala-yapıştır
• DPI, yakınlaştırma ve işleme kalitesi seçenekleri için PDF oluşturma ayarları örneğini okuyun
• Mevcut PDF'lerden metin ve görüntü çıkarmayı nasıl yapacağınızı görün
• Java uygulamasından programatik olarak PDF'leri yazdırmayı öğrenin
• Tam PdfDocument yöntem listesi için IronPDF for Java API referansını inceleyin

Su işareti olmadan PDF oluşturmak için ücretsiz denemeye başlayın veya bir üretim projesine IronPDF eklemek için lisans seçeneklerini görüntüleyin.

---

Hızlı Öğretici Erişimi

Bu Eğitimi Java Kaynak Kodu olarak İndirin

Bu eğitim için tam HTML'den PDF'ye Java kaynak kodu, ücretsiz indirilebilir sıkıştırılmış bir IntelliJ projesi olarak mevcuttur.

İndir

Bu Eğitimi GitHub'da Keşfedin

Bu proje için kaynak kodu, Eclipse veya diğer Java IDE'lerine de aktarılabilen bir IntelliJ IDEA projesi olarak GitHub'da mevcuttur.

IronPDF for Java format-pdfs örnekleri

API Referansını Görüntüle

Tüm sınıfların, yöntemlerin, alanların ve enumların ayrıntılarını kapsayan IronPDF for Java API referansını, com.ironsoftware.ironpdf paketinde keşfedin.

IronPDF Java API Referansını Görüntüle