如何使用 IronPdfEngine
IronPdfEngine 是一個 gRPC 伺服器,設計來管理各種 IronPDF 操作,包括創建、寫入、編輯和閱讀 PDF。
如何將 IronPdfEngine 作為遠程伺服器使用
- 安裝 Java 函式庫以使用 IronPdfEngine
- 在pom.xml文件中包含該庫
- 利用 setIronPdfEngineHost 方法配置主機
- 使用 setIronPdfEnginePort 方法來配置埠
- 使用IronPdfEngine以與Chrome相同的渲染器將HTML渲染為PDF
IronPdf for Java 和 IronPdfEngine
IronPdf for Java 需要 IronPdfEngine 才能運行。Java 代碼只是 IronPdfEngine gRPC 的 API 掩碼。因此,當您在 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>
優點
- 您的應用程式包將會很小。
- 可以部署在多個平台上。
缺點
- 第一次運行需要網路連線
- 啟動時間較慢
選項 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>
適用於 Windows x86
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-windows-x86</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>
適用於 Linux x64
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-linux-x64</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>
適用於 macOS x64
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-macos-x64</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>
適用於 macOS ARM
<dependency>
<groupId>com.ironsoftware</groupId>
<artifactId>ironpdf-engine-macos-arm64</artifactId>
<version>20xx.xx.xxxx</version>
</dependency>
請注意
優點
- 啟動時間更快。
- 安裝相依性之後不需要網路連接。
缺點
- 您的應用程式套件將會很大。
- 需要指定目標平台。
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();
如何連接
假設 IronPdfEngine 已經在 123.456.7.8:33350
遠端運行
請注意
您只需要告訴 IronPDF IronPdfEngine 在哪裡 (請確保地址可訪問,未被防火牆阻擋)在應用程式的初始階段加入這段程式碼 (或在調用任何 IronPDF 方法之前).
com.ironsoftware.ironpdf.Settings.setIronPdfEngineHost("123.456.7.8");
com.ironsoftware.ironpdf.Settings.setIronPdfEnginePort(33350);
就是這麼簡單! 之後,您的應用程式將連接到遠端的IronPdfEngine。!
對於遠端 IronPdfEngine,不需要將 IronPdfEngine 安裝為依賴項。您可以跳過標題為 "選項 2(推薦)將 IronPdfEngine 安裝為依賴項.