如何使用IronPdfEngine
IronPdfEngine 是一个 gRPC 服务器,旨在管理各种 IronPDF 操作,包括创建、写入、编辑和读取 PDF 文件。
如何将 IronPdfEngine 用作远程服务器
- 安装 Java 库以使用 IronPdfEngine
- 在 pom.xml 文件中加入程序库
- 使用 setIronPdfEngineHost 方法配置主机
- 利用 setIronPdfEnginePort 方法配置端口
- 使用 IronPdfEngine 将 HTML 渲染为 PDF,其渲染器与 Chrome 浏览器相同
{链接到 ironpdf.com 上下载 IronPDF for Java}。
IronPDF for Java 和 IronPdfEngine
IronPDF for Java 需要 IronPdfEngine才能运行。 Java 代码只是 IronPdfEngine gRPC 的 API 屏蔽。 因此,当您调用 IronPDF for Java 中的任何方法时,魔法将在 IronPdfEngine 中发生!
默认情况下,IronPDF for Java 会生成 IronPdfEngine 作为子进程,并与之对话,直至应用程序关闭。
请注意
使用本地 IronPdfEngine 的 Java 版 IronPdf
方案 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>
请注意
优点
- 更快的启动时间。
- 安装依赖项后无需访问互联网。
幻灯片
- 您的应用程序包将会很大。
- 需要指定目标平台。
使用远程IronPdfEngine的IronPDF for Java
要使用远程 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 作为依赖项安装."