1. IronPDF
2. 入门
3. 使用IronPdfEngine

如何使用IronPdfEngine

IronPdfEngine 是一个 gRPC 服务器，旨在管理各种 IronPDF 操作，包括创建、写入、编辑和读取 PDF 文件。

{下载 IronPDF for Java 的链接在 ironpdf.com}

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

默认情况下，在将IronPDF安装到Java项目中后，首次运行时，IronPDF将检测您的平台（例如，Windows x64）并从互联网下载正确的IronPdfEngine二进制文件。

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

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

优点

• 您的应用程序包将会很小。
• 可以部署在多个平台上

幻灯片

• 首次运行需要连接互联网。
• 启动时间慢

方案 2（推荐）：将 IronPdfEngine 作为附属程序安装

IronPdf Java允许您添加IronPdfEngine作为依赖项。 这些IronPdfEngine依赖项将IronPdfEngine捆绑到一个.zip文件中，并将自动提取并使用。

您可以选择安装一个或多个IronPdfEngine依赖项。

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

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

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

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

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

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

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

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

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

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

优点

• 更快的启动时间。
• 安装依赖项后无需访问互联网。

幻灯片

• 您的应用程序包将会很大。
• 需要指定目标平台。

IronPdf for Java with Remote IronPdfEngine

要使用远程 IronPdfEngine，需要特定版本的 IronPdfEngine。 例如，如果IronPdf for Java 版本2024.2.2 需要IronPdfEngine 版本2024.2.2，不要使用IronPdfEngine 版本2024.2.1。使用getIronPdfEngineVersion方法来检查所需版本。

String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();

String ironPdfEngineVersion = Settings.getIronPdfEngineVersion();

如何连接

假设 IronPdfEngine 在远程机器上运行，地址为123.456.7.8:33350

参阅关于如何提取和运行 IronPdfEngine 的说明

您只需告诉IronPdf IronPdfEngine的位置（请确保该地址可访问，不被防火墙阻止）。 在您的应用程序的初始阶段（或者在调用任何IronPDF方法之前）添加此代码。

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

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

就这么简单！ 之后，您的应用程序将连接到远程 IronPdfEngine！

对于远程IronPdfEngine，无需将IronPdfEngine安装为依赖项。 您可以跳过标题为“选项2（推荐）将IronPdfEngine作为依赖项安装”的部分。