1. IronPDF
  2. 文档
  3. 入门

IronPDF for Java - 在 Java 应用程序中创建、编辑和阅读 PDF

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

关于IronPDF for Java

IronPDF for Java 是 Iron Software 开发和维护的一个库，可帮助软件工程师在 Java 8+、Kotlin 和 Scala 项目中创建、编辑和提取 PDF 内容。

IronPDF for Java 建立在IronPDF for .NET.

IronPDF for Java 使用 gRPC 与 IronPdfEngine 通信。

IronPDF擅长于

  • 从以下内容生成 PDF：HTML、URL、JavaScript、CSS 和多种图像格式
  • 添加页眉/页脚、签名、附件、密码和安全性
  • 性能优化：完全多线程和异步支持
  • 还有更多! 访问我们的网站，查看我们的所有代码示例和50 多项功能的完整列表

使用IronPDF for Java

将 IronPDF 定义为 Java 依赖项

pom.xml 依赖

要将 IronPDF 定义为依赖项，请在您的 pom.xml 中添加以下内容：

<dependencies>

<!--Adds IronPDF Java. Use the latest version in the version tag.-->
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>20xx.xx.xxxx</version>
    </dependency>

<!--Adds the slf4j logger which IronPDF Java uses.-->
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.3</version>
    </dependency>

</dependencies>
XML

下载 jar 文件

可选地手动下载 IronPDF JAR 文件供独立使用。

首次构建和运行

当您第一次运行项目时，IronPdfEngine 二进制文件将自动下载。当您首次调用任何 IronPdf 功能时，IronPdfEngine 进程将启动，并在您的应用程序关闭或进入空闲状态时停止。

将 IronPDF Engine 作为 Maven 依赖项安装

通过将IronPdfEngine添加为Maven依赖项，二进制文件将在加载依赖项期间被下载。

  • 这种方法将避免漫长的启动过程，因为IronPdfEngine二进制文件将已经被下载。

  • 此外，这将有利于不允许从外部源下载的部署设置。

    如果您正在开发多平台应用，请将以下一个或多个代码片段添加到您的 pom.xml 文件中：

适用于 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

开始编写Java代码

一旦定义了依赖关系，您就可以在 Java 代码的顶部添加 import com.ironsoftware.ironpdf.* 语句，开始使用。 以下是一个简单的HTML转PDF示例，以便入门：

// Import statement for IronPDF Java
import com.ironsoftware.ironpdf.*;

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Set a log path
Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

// Render the HTML as a PDF. Stored in myPdf as type PdfDocument
PdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1> ~Hello World~ </h1> Made with IronPDF!");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("html_saved.pdf"));
JAVA

这是另一个演示 URL 转 PDF 的简单示例：

// Import statement for IronPDF Java
import com.ironsoftware.ironpdf.*;

// Apply your license key
License.setLicenseKey("YOUR-LICENSE-KEY");

// Set a log path
Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));

// Render the URL as a PDF. Stored in myPdf as type PdfDocument
PdfDocument myPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com/java");

// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("url_saved.pdf"));

PdfDocument pdfDocument = PdfDocument.renderUrlAsPdf("https://ironpdf.com/java");
JAVA

完整的 Main.java 示例

package org.example;  

// Import statement for IronPDF Java  
import com.ironsoftware.ironpdf.*;  
import java.io.IOException;  
import java.nio.file.Paths;  

public class Main {  

    public static void main(String [] args) throws IOException {
        // Apply your license key
        License.setLicenseKey("YOUR-LICENSE-KEY");  

        // Set a log path  
        Settings.setLogPath(Paths.get("C:/tmp/IronPdfEngine.log"));  

        // Render the HTML as a PDF. Stored in myPdf as type PdfDocument  
        PdfDocument myPdf = PdfDocument.renderHtmlAsPdf("<h1> ~Hello World~ </h1> Made with IronPDF!");  

        // Save the PdfDocument to a file  
        myPdf.saveAs(Paths.get("html_saved.pdf"));

    }  

}
JAVA

更多设置信息

注意：请注意，在调用任何IronPDF方法之前，必须执行所有设置、日志和许可操作。

应用许可证密钥

要应用您的许可密钥，请在方法顶部添加以下内容：

com.ironsoftware.ironpdf.License.setLicenseKey("YOUR-LICENSE-KEY");
JAVA

记录

IronPDF Java 使用slf4j 日志用于记录目的。 要启用日志记录，请使用

com.ironsoftware.ironpdf.Settings.setDebug(true);
JAVA

要指定 IronPdfEngine 日志路径，请添加：

com.ironsoftware.ironpdf.Settings.setLogPath(Paths.get("C:/tmp/myIronPdfEngineLog.log"));
JAVA

许可与支持可用

购买 IronPDF 许可证在实时项目中使用。 还提供 30 天试用许可证试用版用户.

有关代码示例、教程、许可信息和文档的完整列表，请访问：IronPDF for Java 资源.

有关更多支持和查询，请联系我们的支持团队.