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 Java "取得成功并广受欢迎的基础上开发的。 IronPDF for .NET.

IronPDF for Java 使用 gRPC 与 "IronPdfEngine "通信。

IronPDF 擅长

  • 从 HTML、URL、JavaScript、CSS 和多种图像格式生成 PDF
  • 添加页眉/页脚、签名、附件、密码和安全性
  • 性能优化：完全多线程和异步支持

  • 更多! 访问我们的网站，查看我们所有的代码示例和

    a 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 文件

可选项 下载 .jar 手动

首次构建和运行

首次运行项目时，将自动下载IronPdfEngine二进制文件。第一次调用任何 IronPdf 函数时，"IronPdfEngine "进程将启动，应用程序关闭或进入空闲阶段时，"IronPdfEngine "进程将停止。

将 IronPDF 引擎作为 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 page 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.

如需更多支持和咨询，请 询问我们的团队.