1. IronPDF
  2. 操作指南
  3. 使用IronPdfEngine

如何使用 IronPdfEngine

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPdfEngine 是一個 gRPC 伺服器，設計來管理各種 IronPDF 操作，包括創建、寫入、編輯和閱讀 PDF。

如何將 IronPdfEngine 作為遠程伺服器使用

  1. 安裝 Java 函式庫以使用 IronPdfEngine
  2. 在pom.xml文件中包含該庫
  3. 利用 setIronPdfEngineHost 方法配置主機
  4. 使用 setIronPdfEnginePort 方法來配置埠
  5. 使用IronPdfEngine以與Chrome相同的渲染器將HTML渲染為PDF

Java Maven 圖書館用於 PDF

安裝與 Maven

<dependency>
   <groupId>com.ironsoftware</groupId>
   <artifactId>ironpdf</artifactId>
   <version>2024.9.1</version>
</dependency>
search.maven.org/artifact/com.ironsoftware/ironpdf
或
Java PDF JAR

下載 JAR

  下載 JAR

手動安裝到您的項目中

IronPdf for Java 和 IronPdfEngine

IronPdf for Java 需要 IronPdfEngine 才能運行。Java 代碼只是 IronPdfEngine gRPC 的 API 掩碼。因此，當您在 IronPdf for Java 中調用任何方法時，神奇的事情將在 IronPdfEngine 內部發生。!

預設情況下，IronPDF for Java 會將 IronPdfEngine 作為子進程啟動，並與其通訊，直到您的應用程式關閉為止。

請注意
每個版本的 IronPDF for Java 需要特定版本的 IronPdfEngine。不支援跨版本。

使用本地 IronPdfEngine 的 IronPdf for Java

選項 1 在運行時下載 IronPdfEngine

默認情況下，在您的 Java 專案中安裝 IronPdf 後，首次運行時，IronPdf 將檢測您的平台 (例如：Windows x64) 並從互聯網下載正確的IronPdfEngine二進制文件。

<dependency>
   <groupId>com.ironsoftware</groupId>
   <artifactId>ironpdf</artifactId>
   <version>20xx.xx.xx</version>
</dependency>
XML

優點

  • 您的應用程式包將會很小。
  • 可以部署在多個平台上。

缺點

  • 第一次運行需要網路連線
  • 啟動時間較慢

選項 2 (推薦) 將 IronPdfEngine 安裝為依賴項目

IronPdf Java 允許您將 IronPdfEngine 安裝為依賴項目。這些 IronPdfEngine 依賴項目將 IronPdfEngine 綑綁到一個 .zip 文件中，並將自動解壓並使用。

您可以選擇安裝一個或多個這些 IronPdfEngine 依賴項目。

[{我(ironpdf 和 ironpdf-engine-xxx-xxx 依賴版本必須相同。

ironpdf-engine-xxx-xxx 依賴版本並不指 IronPdfEngine 內部的版本。

)}]

適用於 Windows x64

 <dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

適用於 Windows x86

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-windows-x86</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

適用於 Linux x64

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-linux-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

適用於 macOS x64

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-x64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

適用於 macOS ARM

<dependency>
    <groupId>com.ironsoftware</groupId>
    <artifactId>ironpdf-engine-macos-arm64</artifactId>
    <version>20xx.xx.xxxx</version>
</dependency>
XML

請注意
每個依賴項都相當龐大，全都安裝不是個好主意。

優點

  • 啟動時間更快。
  • 安裝相依性之後不需要網路連接。

缺點

  • 您的應用程式套件將會很大。
  • 需要指定目標平台。

IronPdf for Java 與遠端 IronPdfEngine

要使用遠端 IronPdfEngine，需要特定版本的 IronPdfEngine。例如，如果 IronPdf for Java 版本 2024.2.2 需要 IronPdfEngine 版本 2024.2.2，不要使用 IronPdfEngine 版本 2024.2.1。使用 getIronPdfEngineVersion 方法檢查所需的版本。

String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();
JAVA

如何連接

假設 IronPdfEngine 已經在 123.456.7.8:33350 遠端運行

請注意
若要遠端執行 IronPdfEngine，請參考如何拉取並執行 IronPdfEngine.

您只需要告訴 IronPDF IronPdfEngine 在哪裡 (請確保地址可訪問，未被防火牆阻擋)在應用程式的初始階段加入這段程式碼 (或在調用任何 IronPDF 方法之前).

com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);
JAVA

就是這麼簡單! 之後，您的應用程式將連接到遠端的IronPdfEngine。!

對於遠端 IronPdfEngine，不需要將 IronPdfEngine 安裝為依賴項。您可以跳過標題為 "選項 2（推薦）將 IronPdfEngine 安裝為依賴項.