如何使用 IronPdfEngine

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

IronPdfEngine 是一个 gRPC 服务器,用于管理各种 IronPDF 操作,包括创建、编写、编辑和读取 PDF。

Java Maven 库用于 PDF

安装使用 Maven

<dependency>
   <groupId>com.ironsoftware</groupId>
   <artifactId>ironpdf</artifactId>
   <version>2024.9.1</version>
</dependency>
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 的 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 上远程运行。

[{i:(要远程运行 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 作为依赖项安装."