Seçenek 1: IronPdfEngine'i Çalışma Zamanında İndir

Varsayılan olarak, ironpdf çekirdek bağımlılığı eklendikten sonra, IronPDF ilk çalıştırmada ana platformu (örneğin, Windows x64 veya Linux x64) algılar ve internetten uygun IronPdfEngine ikili dosyasını indirir.

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xx</version>
</dependency>

İlk indirmeden sonra, ikili dosya yerel olarak önbelleğe alınır ve sonraki çalıştırmalar ağ çağrısı olmadan başlatılır.

Seçenek 2: IronPdfEngine'i Bağımlılık Olarak Paketle (Önerilen)

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

//:path=pom.xml
<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>

Gerekli IronPdfEngine Sürümünü Nasıl Doğrularsınız?

Sürüm eşleştirme kesinlikle zorunludur — Java için IronPDF 2024.2.2 tam olarak IronPdfEngine 2024.2.2 gerektirir. Sunucuyu devreye almadan önce gerekli sürümü doğrulamak için getIronPdfEngineVersion kullanın:

//:path=Main.java
// Retrieve the IronPdfEngine version required by this Java library build
String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
System.out.println("Required IronPdfEngine version: " + ironPdfEngineVersion);

//:path=Main.java
// Retrieve the IronPdfEngine version required by this Java library build
String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
System.out.println("Required IronPdfEngine version: " + ironPdfEngineVersion);

Dönen sürüm dizesi ile uyumlu IronPdfEngine Docker imajını veya ikilisini dağıtın veya alın.

Uzak Bağlantı Nasıl Yapılandırılır?

IronPdfEngine'in 123.456.7.8:33350 adresinde çalıştığını varsayalım. Herhangi bir IronPDF yöntemini çağırmadan önce ana bilgisayarı ve bağlantı noktasını ayarlayın. En iyi uygulama yöntemi, bu çağrıları uygulama başlatılmasında, herhangi bir PDF işlemi gerçekleşmeden önce yerleştirmektir:

//:path=Main.java
// Configure IronPDF for Java to connect to a remote IronPdfEngine instance
com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);

//:path=Main.java
// Configure IronPDF for Java to connect to a remote IronPdfEngine instance
com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);

Bu iki satır çalıştırıldıktan sonra, uygulamanızdaki tüm IronPDF çağrıları uzak sunucuya yönlendirilir. Yerel IronPdfEngine alt işlemi başlatılmaz ve pom.xml'da platforma özgü motor bağımlılığı gerekmez.

Tamam bir Uzak Kurulum Ne Görünür?

Aşağıdaki örnek, bir uzak IronPdfEngine örneğine bağlanır ve bir HTML dizesini bir PDF dosyasına işler — yerel modda kullanılan aynı API, sadece yapılandırma farklıdır:

//:path=Main.java
import com.ironsoftware.ironpdf.*;

public class Main {
    public static void main(String[] args) throws Exception {
        // Point the library to the remote IronPdfEngine server
        Settings.setIronPdfEngineHost("123.456.7.8");
        Settings.setIronPdfEnginePort(33350);

        // Render HTML to PDF — IronPdfEngine on the remote host performs the work
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from remote IronPdfEngine</h1>");
        pdf.saveAs("output.pdf");
    }
}

//:path=Main.java
import com.ironsoftware.ironpdf.*;

public class Main {
    public static void main(String[] args) throws Exception {
        // Point the library to the remote IronPdfEngine server
        Settings.setIronPdfEngineHost("123.456.7.8");
        Settings.setIronPdfEnginePort(33350);

        // Render HTML to PDF — IronPdfEngine on the remote host performs the work
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf("<h1>Hello from remote IronPdfEngine</h1>");
        pdf.saveAs("output.pdf");
    }
}

İşlenen PDF, gRPC üzerinden Java işlemine döndürülür ve yerel olarak kaydedilir. Uzak sunucu, tüm Chrome tabanlı işlemleri, yazı tipi yüklemeyi ve kaynak çözümünü yönetir.