如何用 Java 创建 PDF 文件

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

*使用 Java 以编程方式创建 PDF 允许开发人员自动创建 PDF 文档,作为其应用程序的一部分。这在各种情况下都很有用,例如按需生成发票、报告或其他类型的新 PDF 文档。

本《操作指南》将介绍如何使用 IronPDF 在 Java 应用程序中以编程方式创建 PDF 文件

IronPDF Java PDF 库

IronPDF 是一个 Java 库,用于从 HTML 创建 PDF 文档。它设计得易于使用。它提供创建和自定义 PDF 的功能,包括

1.可添加文本、图像和其他类型的内容

2.能够选择字体和颜色,控制文档的布局和格式

IronPDF 建立在 .NET Framework 的基础之上,可以在 .NET 和 Java 应用程序中使用。这使它成为在各种情况下创建 PDF 的多功能工具。

除了核心的 PDF 生成功能外,IronPDF 还支持其他与 PDF 相关的任务。其中包括其他文件格式之间的转换、从 PDF 中提取文本和数据,以及使用密码加密保护 PDF。

在 Java 应用程序中创建 PDF 文档的步骤

先决条件

要在 Maven 项目中使用 IronPDF 创建 PDF,请确保计算机已安装以下前提软件:

  1. Java 开发工具包 (JDK): 编译和运行 Java 应用程序需要 JDK。请从 甲骨文网站.

  2. Maven: 从中央资源库下载项目库需要使用 Maven。从 Apache Maven 网站.

  3. IronPDF 库: IronPDF 库可作为依赖项添加到 Maven 项目中。包含其 Maven 依赖工件 (以及可选的 slf4j 依赖项) 在 Maven 项目的 pom.xml 文件中,如下所示:
<dependency>
   <groupId>com.ironsoftware</groupId>
   <artifactId>com.ironsoftware</artifactId>
   <version>2024.9.1</version>
</dependency>

编写代码前的重要步骤

首先,将下面的语句添加到 Java 源文件的顶部,在该文件中编写的代码将导入项目范围中所需的 IronPDF 库类。

import com.ironsoftware.ironpdf.*;
JAVA

接下来,通过调用 "main "方法中的 setLicenseKey 方法,使用有效的许可证密钥配置 IronPDF (在其他代码行之前).

License.setLicenseKey("Your license key");
JAVA

注意创建不带水印的 PDF 文件需要许可证密钥。 购买 许可证密钥或 获得免费试用 许可证密钥。否则,请继续下一步 (不添加上面一行) 免费生成带水印的新 PDF 文档

Java 中从 HTML 字符串创建 PDF 文件

使用 `renderHtmlAsPdf()方法将 HTML 字符串转换为新的 PDF 文档。

renderHtmlAsPdf 方法的参数中,传递 HTML 标记字符串。IronPDF 将把 HTML 内容转换成一个新的 PdfDocument 实例。

String htmlString = "<h1>Hello World!</h1><p>This is an example HTML string.</p>";
PdfDocument pdf = PdfDocument.renderHtmlAsPdf(htmlString);
JAVA

然后,使用 saveAs 方法将 PDF 保存到本地系统的路径中:

pdf.saveAs(Paths.get("html.pdf"));
JAVA

上面的代码行创建了一个名为 "html.pdf "的文件,其中包含 HTML 字符串的内容。

用 Java 从 HTML 页面创建 PDF 文件

使用下面的示例从 Java 本地存储的 HTML 文件创建 PDF 文件:

PdfDocument myPdf = PdfDocument.renderHtmlFileAsPdf("example.html");
// Save the PdfDocument to a file
myPdf.saveAs(Paths.get("html_file_saved.pdf"));
JAVA

如上所示,"renderHtmlFileAsPdf "方法可从 HTML 文件创建 PDF 文件。该方法接受一个字符串 (或路径) 包含文件系统中 HTML 文件的路径。

IronPDF 会以与网络浏览器相同的方式渲染 HTML 文件中的 HTML 元素以及影响这些元素的 CSS 和 JavaScript 内容。

接下来,使用目标文件路径调用 saveAs 方法,将 PDF 文件保存到特定位置,就像上一个示例中所做的那样。

用 Java 从 URL 创建 PDF 文件

renderUrlAsPdf 方法通过 URL 引用的网页创建 PDF 文件。将网页的 URL 作为参数传递给该方法,如下所示:

PdfDocument urlToPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");
// Save the PdfDocument to a file
urlToPdf.saveAs(Paths.get("urlToPdf.pdf"));
JAVA

有关将网页转换为 PDF 的更多信息,请访问 URL 转 PDF 代码示例 page.

PDF 文件格式

使用 "ChromePdfRenderOptions "类为新的 PDf 文件指定所需的格式。可配置的设置包括页面方向、页面大小和页边距大小等。将 "ChromePdfRenderOptions "类的实例作为第二个参数传递给 "renderUrlAsPdf "方法,以生成具有所需设置的 PDF 文档。请参考 代码示例 以获取更多有关如何使用 ChromePdfRenderOptions 类的信息。

密码保护 PDF 文件

IronPDF 使用 SecurityOptions 类生成受密码保护的 PDF 文件。首先,创建一个 SecurityOptions 实例,然后使用 setUserPassword 方法设置密码。

SecurityOptions securityOptions = new SecurityOptions();
securityOptions.setUserPassword("shareable");
JAVA

安全设置通过 PDF 的 SecurityManager 应用于 PDF。接下来的代码片段将把这些设置应用到我们在 URL 转 PDF 示例中创建的 PDF 文档:

SecurityManager securityManager =  urlToPdf.getSecurity();
securityManager.setSecurityOptions(securityOptions);
urlToPdf.saveAs("protected.pdf");
JAVA

PDF 文件现在受密码保护。打开 PDF 文件会弹出密码提示:

Java 创建 PDF - 图 1

输入正确的密码后,PDF 文件将如期打开。

Java 创建 PDF - 图 2

阅读有关其他安全和元数据设置的更多信息 这里.

完整源代码

本教程的完整源代码文件包含在下面:

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

public class App 
{
    public static void main( String [] args ) throws IOException, PrinterException
    {
     // Apply your license key
        License.setLicenseKey("Your License Key");     
        String htmlString = "<h1>Hello World!</h1><p>This is an example HTML string.</p>";
        PdfDocument pdf = PdfDocument.renderHtmlAsPdf(htmlString);
        pdf.saveAs(Paths.get("html.pdf"));
        PdfDocument myPdf = PdfDocument.renderHtmlFileAsPdf("example.pdf");
        myPdf.saveAs(Paths.get("html_file_saved.pdf"));
        PdfDocument urlToPdf = PdfDocument.renderUrlAsPdf("https://ironpdf.com");
        // Save the PdfDocument to a file
        urlToPdf.saveAs(Paths.get("urlToPdf.pdf"));

        // Password-protect the URLToPdf File.
        SecurityOptions securityOptions = new SecurityOptions();
        securityOptions.setUserPassword("shareable");
        SecurityManager securityManager =  urlToPdf.getSecurity();
        securityManager.setSecurityOptions(securityOptions);       
        urlToPdf.saveAs(Paths.get("protected.pdf"));
    }
}
JAVA

IronPDF 可渲染所有图像和文本,而不会丢失任何格式。PDF 文件中的按钮可点击,文本框可编辑。

摘要

在本操作指南中,我们介绍了 Java 如何使用 IronPDF 创建 PDF。IronPDF 是一个功能强大的库,允许开发人员在 Java 中轻松生成和处理 PDF 文件。

它还提供了简单直观的应用程序接口(API),可轻松从 HTML 文件、XML 文档或其他来源创建 PDF。无论您需要生成报告、发票还是其他任何类型的文档,IronPDF 都能帮助您快速轻松地完成工作。

IronPDF 并不是一个开源的 Java 库。它有一个 商业许可 从 $749 开始。您可以获得 免费试用 在生产中进行测试。

*下载 软件产品。