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 将 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 作为子进程，并与之对话，直至应用程序关闭。

请注意
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>
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

请注意
每个依赖项都相当大，因此不宜全部安装。

优点

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

幻灯片

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

使用远程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();
JAVA

如何连接

假设 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);
JAVA

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

对于远程IronPdfEngine，无需将IronPdfEngine安装为依赖项。 你可以跳过题为 "方案 2（推荐）将 IronPdfEngine 作为依赖项安装."