如何在 Java 中填写 PDF 表单（教程）

已更新:一月 10, 2026

Translated

View the article in English

IronPDF 使 Java 开发人员能够通过加载现有 PDF、使用 getForm() 方法访问表单字段、使用 setFieldValue() 设置值并保存已填充的文档，以编程方式填充 PDF 表单--非常适合在业务应用程序中自动处理文档。

as-heading:2（快速入门：在 Java 中填写 PDF 表单）

```java {title="FillPDFForm.java"} // 1.在 Maven 项目中添加 IronPDF 依赖关系 // 2.加载您的 PDF 表单 PdfDocument form = PdfDocument.fromFile("form.pdf")； // 3.填写表格字段 form.getForm().setFieldValue("firstname", "John")； // 4.保存填好的 PDF form.saveAs(Paths.get("filled_form.pdf"))； // 5.运行您的 Java 应用程序生成已填充的 PDF


<! -- 待办事项：在此处添加图片 -->
<! --![介绍的视觉演示](/static-assets/images/TODO/introduction-screenshot.webp) -->
<！--描述：截图或图表 -->

本文重点介绍在 Java 中以编程方式填写 PDF 表单。 一个常见的使用案例是，应用程序用户界面收集的用户数据必须转换成 PDF 格式以便存档。

在收集用户输入数据后，应用程序需要以编程方式创建 PDF 表单。 这些填写好的文档要么保存起来以备将来使用，要么进行修改。 现有多个用于 PDF 工作的 Java PDF 库，包括 PDFBox、iText7 和 IronPDF。 本文介绍了如何使用 IronPdf 填写交互式表格。 对于开发需要文档自动化的业务应用程序的开发人员，IronPDF 提供了用于[创建 PDF 表单](https://ironpdf.com/java/how-to/create-forms/)和管理表单数据的工具。

<div class="hsg-featured-snippet">
<h2>如何在 Java 中填写 PDF 表单</h2>
<ol>
<li><a class="js-modal-open" data-modal-id="download-modal" href="#download-modal">安装 Java 库以填写 PDF 表单</a>。</li>
<li>加载包含表单字段的现有 PDF</li>
<li>使用 <code>getForm</code> 方法选择已加载 PDF 的表单字段</li>
<li>使用 <code>setFieldValue</code> 方法设置指定表单字段的值</li>
<li>导出PDF文档</li>
</ol>
</div>

<h2>什么是 IronPDF，为什么使用它制作 PDF 表单？

IronPDF 是一个 [ 用于创建和编辑 PDF 的 Java PDF 库](https://ironpdf.com/java/)，允许开发人员在 Java 应用程序中创建、编辑和操作 PDF 文档。 该库与 Java 兼容，只需最少的代码即可集成到任何基于 Java 的项目中。

IronPDF 提供的功能包括文本和图像处理、文档安全和数字签名功能。 使用 IronPDF，开发人员可以高效地生成 PDF 文档。 该库还提供对[PDF压缩](https://ironpdf.com/java/how-to/compress-pdf-java-tutorial/)的支持，以优化文件大小，并提供[打印功能](https://ironpdf.com/java/how-to/java-print-pdf-tutorial/)，以便与物理打印机集成。

在处理表单时，IronPDF 可保持文档格式，同时提供对所有表单元素的编程访问。 因此，它适用于批量处理表单、使用数据库信息预填充字段或将表单填写集成到现有的 Java 工作流中。 正如我们的 [ 表单数据示例](https://ironpdf.com/java/examples/form-data/)所示，通过该库的 API，您只需使用最少的代码即可开始填写 PDF 表单。

<h2>如何使用 IronPDF 填写 PDF 表单？

让我们来看看如何使用这个 Java PDF 库以编程方式填写 PDF 表单。 IronPDF 可处理各种表单字段类型，包括文本框、复选框、单选按钮和下拉列表。 该库保留了格式，并确保填写的表格符合 PDF 标准。

<h3>如何在我的 Maven 项目中安装 IronPDF？

通过 Maven 安装 IronPDF for Java：

1.打开项目中的 `pom.xml` 文件。  
2. Add the following dependencies within the `<code><dependencies></dependencies></code>` tag.  
3.保存 `pom.xml` 文件并在项目目录中运行 `mvn install` 。 这将安装 IronPDF for Java 及其附属程序。 有关详细信息，请参阅 [Sonatype Central Repository Page for IronPDF](https://central.sonatype.com/artifact/com.ironsoftware/ironpdf/2023.1.1) 。

有关不同环境下的详细设置指导，请查看我们的 [ 入门概述](https://ironpdf.com/java/docs/)。 对于云部署，我们提供了 [AWS部署](https://ironpdf.com/java/get-started/aws/)、[Azure Functions](https://ironpdf.com/java/get-started/azure/) 和 [Google Cloud](https://ironpdf.com/java/get-started/google-cloud/) 的指南。

现在，您可以在 Java 代码中使用 IronPdf 了。

<h3>如何使用 Java 以编程方式填充 PDF 文档？

以下代码演示了如何使用 IronPDF 来 [ 使用 HTML 标记用 Java 创建和填写 PDF 表单](https://ironpdf.com/java/examples/form-data/)。代码从 IronPdf 中导入了必要的类，并使用 `Paths.get` 方法指定了生成的 PDF 表单的保存位置。 当您需要[将 HTML 转换为 PDF](https://ironpdf.com/java/tutorials/html-to-pdf/) 同时保持表单功能时，这种方法非常有用。

```java
import com.ironsoftware.ironpdf.PdfDocument;  
import com.ironsoftware.ironpdf.render.ChromePdfRenderOptions;  
import java.io.IOException;  
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

public class App {

    // Main method to execute the program
    public static void main(String[] args) throws IOException {
        // Specify where the output PDF will be saved
        Path outputLocation = Paths.get("assets/BasicForm.pdf");  

        // HTML string which represents the form to be converted to PDF
        String formHTML = "<html>"
            + "<body>"
            + "<h2>Editable PDF Form</h2>"
            + "<form>"
            + "First name: <br> <input type='text' name='firstname' value=''> <br>"
            + "Last name: <br> <input type='text' name='lastname' value=''>"
            + "</form>"
            + "</body>"
            + "</html>";  

        // Set up PDF render options to create forms from HTML
        ChromePdfRenderOptions renderOptions = new ChromePdfRenderOptions();  
        renderOptions.setCreatePdfFormsFromHtml(true);  

        // Render the HTML as a PDF and save it to the specified location
        PdfDocument.renderHtmlAsPdf(formHTML, renderOptions).saveAs(outputLocation);

        // #2 Use Case: Writing Values to the PDF Form  
        PdfDocument form = PdfDocument.fromFile(outputLocation);  

        // Set the value of the firstname input field  
        form.getForm().setFieldValue("firstname", "Minnie");  

        // Set the value of the lastname input field  
        form.getForm().setFieldValue("lastname", "Mouse");  

        // Save the changes to the PDF Form  
        form.saveAs(Paths.get("assets/BasicForm_Filled.pdf"));
    }
}

第一个代码块通过使用 PdfDocument.renderHtmlAsPdf 方法转换 HTML 表单标记来创建 PDF 表单。 ChromePdfRenderOptions 对象将 createPdfFormsFromHtml 属性设置为 true，从而使 HTML 表单可编辑。使用 saveAs 方法将生成的 PDF 保存到指定位置。有关更多渲染选项，请参阅我们的 PDF 生成设置指南。

第二块演示填写创建的 PDF 表单。 PdfDocument.fromFile 方法从文件路径加载 PDF 表单。 getForm 方法可访问表单字段，而 setFieldValue 方法可为 firstname 和 lastname 输入字段设置值。使用 saveAs 方法将更改保存到新文件中。

输出结果是什么样的？在第一个区块中，IronPDF 创建了一个带有两个文本框表单字段的基本 PDF 文档。文档的 PDF 规范允许在表单字段中输入内容。以下是输出结果：！[简单的 PDF 表单，显示带有蓝色输入框的可编辑的姓和名文本字段](/static-assets/IronPDF-java/howto/java-fill-pdf-form-tutorial/java-fill-pdf-form-tutorial-1.webp)。在第二个区块中，每个文本字段都设置了值，每个表单字段都填入了数据。以下是已填充 PDF 文档的截图： ![Editable PDF form with filled First name 'Minnie' and Last name 'Mouse' fields demonstrating IronPDF form completion](/static-assets/ironpdf-java/howto/java-fill-pdf-form-tutorial/java-fill-pdf-form-tutorial-2.webp).

使用 IronPDF 制作 PDF 表单有哪些主要优势？ IronPDF 为使用 PDF 表单的开发人员提供了多项优势： 1.无缝集成：只需最少的配置即可与现有的 Java 应用程序集成。 2.格式保持：在填写过程中保持准确的表单格式。 3.表单支持：处理文本字段、复选框、单选按钮、下拉按钮等。 4.批量处理：通过迭代数据集自动填写多个表单。 5.云就绪：针对在云平台上部署可扩展应用程序进行了优化。为了安全处理文档，IronPDF for Java 提供[安全和元数据](https://ironpdf.com/java/examples/security-and-metadata/)功能，允许对填写的表格进行密码保护和文档属性管理。总之，IronPDF 是一个在 Java 中处理 PDF 文档的高效库。它能够以编程方式填写 PDF 表单，因此可用于自动化文档处理任务。无论是构建文档管理系统、自动生成发票还是创建个性化报告，IronPDF 都能提供使用 PDF 表单的必要工具。 IronPDF 提供免费试用和 [经济实惠的 IronPDF Java](/java/licensing/) 许可选项，起价为 $799。要开始使用 IronPDF，请访问我们的 [API 参考](https://ironpdf.com/java/object-reference/api/)，了解有关可用功能和方法的详细文档。

常见问题解答

在 Java 中填写 PDF 表单的基本步骤是什么？

要使用 IronPDF 在 Java 中填写 PDF 表单，请按照以下步骤操作：1) 在 Maven 项目中添加 IronPDF 依赖关系；2) 使用 PdfDocument.fromFile() 加载现有的 PDF 表单；3) 使用 getForm() 方法访问表单字段；4) 使用 setFieldValue() 用字段名和值填充字段；5) 使用 saveAs() 保存已填充的 PDF。

如何访问和设置特定表单字段的值？

IronPDF 提供了 getForm() 方法来访问 PDF 中的表单字段。访问表单后，使用 setFieldValue(fieldName, value) 设置特定字段的值。例如：form.getForm().setFieldValue("firstname", "John") 将在 "firstname "字段中填入 John。