如何在 Java 中填充 PDF 表單

如何在Java中填寫PDF表單(教學)

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

IronPDF 可讓 Java 開發人員透過載入現有 PDF、使用 getForm() 方法存取表單欄位、使用 setFieldValue() 設定值,並儲存已填入的文件,以程式化的方式填入 PDF 表單 - 非常適合商業應用程式中的自動化文件處理。

快速入門:在 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


<!-- TODO: 在此添加圖片 -->
<! -- ![介紹的視覺演示](/static-assets/images/TODO/introduction-screenshot.webp) -->
<!--說明:螢幕截圖或圖表 -->

本文著重於以 Java 程式化方式填寫 PDF 表單。 一個常見的使用案例是當應用程式 UI 收集使用者資料時,這些資料必須轉換成 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 方法則可設定 firstnamelastname 輸入欄位的值。 使用 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) 可編輯的 PDF 表單,填入名 "Minnie" 和姓 "Mouse' 欄位,示範 IronPDF 表單完成。

使用 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。

商業應用程式可以自動填表嗎?

是的,IronPDF 專為商業應用程式中的自動化文件處理而設計。您可以從應用程式 UI 收集使用者資料,並以程式化的方式填入 PDF 表單,以便歸檔。該函式庫支援批次處理表單、使用資料庫資訊預先填入欄位,以及將表單填寫整合至現有的 Java 工作流程中。

可以處理哪些類型的 PDF 文件?

IronPDF 可以處理包含互動式表單欄位的現有 PDF 文件。該函式庫可維護文件格式,同時提供對所有表單元素的程式化存取,包括文字欄位、複選框、單選按鈕和其他標準 PDF 表單元件。

本庫與其他 Java PDF 解決方案相比有何優勢?

雖然有多種 Java PDF 函式庫存在,包括 PDFBox 和 iText7,但 IronPDF 提供了更簡單的 API,只需最少的程式碼即可填寫表單。它提供了全面的功能來建立、編輯和處理 PDF 文件,以及 PDF 壓縮和列印支援等附加功能。

除了表格填寫之外,還有哪些其他 PDF 功能?

除了填寫表單之外,IronPDF 還提供文字與影像處理、文件安全性、數位簽章功能、優化檔案大小的 PDF 壓縮功能,以及與實體印表機整合的列印功能。該資料庫還支援從頭開始創建新的 PDF 表單。

Darrius Serrant
全棧軟件工程師 (WebOps)

Darrius Serrant 擁有邁阿密大學計算機科學學士學位,目前任職於 Iron Software 的全栈 WebOps 市場營銷工程師。從小就迷上編碼,他認為計算既神秘又可接近,是創意和解決問題的完美媒介。

在 Iron Software,Darrius 喜歡創造新事物,並簡化複雜概念以便於理解。作為我們的駐場開發者之一,他也自願教學生,分享他的專業知識給下一代。

對 Darrius 來說,工作令人滿意因為它被重視且有實際影響。

準備好開始了嗎?
版本: 2025.12 剛發表