PDF表單是企業和機構常用的數據收集工具，而通過編程方式自動填充PDF表單可以大大提高工作效率。本文將詳細介紹如何使用Java和iText庫來實現PDF表單的自動化填充。

為什么選擇iText庫？

iText是一個強大的PDF操作庫，具有以下優勢：

• 功能全面，支持PDF創建、編輯和填充

• 性能優異，適合處理大量PDF文檔

• 支持復雜的PDF操作如表單填充、數字簽名等

• 活躍的社區支持和良好的文檔

環境準備

在開始之前，請確保：

1. 項目中已添加iText依賴（Maven配置如下）

<dependency><groupId>com.itextpdf</groupId><artifactId>itextpdf</artifactId><version>5.5.13</version>
</dependency>

1. 準備好PDF表單模板（確保是可填寫的PDF表單），具體可以查看使用Adobe Acrobat DC創建PDF表單域的完整指南-CSDN博客

2. 準備好要填充的數據

核心代碼解析

1. 基本表單填充

public static void fillPDFTemplate(Map<String,Object> sourceMap) {PdfReader reader = null;FileOutputStream out = null;try {// 設置中文字體BaseFont bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.EMBEDDED);// 讀取PDF模板reader = new PdfReader(TEMPLATE_PATH);out = new FileOutputStream(NEW_PDF_PATH);PdfStamper stamper = new PdfStamper(reader, out);AcroFields form = stamper.getAcroFields();// 填充文本數據Map<String, String> dataMap = (Map<String,String>) sourceMap.get("dataMap");form.addSubstitutionFont(bfChinese);for(String key : dataMap.keySet()){form.setField(key, dataMap.get(key));}stamper.setFormFlattening(true); // 使表單不可編輯stamper.close();} catch (Exception e) {e.printStackTrace();} finally {// 關閉資源}
}

2. 高級功能：處理多行文本和自動換行

TextField textField = new TextField(stamper.getWriter(), rect, key);
textField.setFont(baseFont);
textField.setFontSize(fontSize);
if (!canFitInOneLine) {textField.setOptions(TextField.MULTILINE | TextField.DO_NOT_SCROLL);
}
textField.setText(text);// 智能對齊：單行居中，多行左對齊
PdfFormField field = textField.getTextField();
field.setQuadding(canFitInOneLine ? PdfFormField.Q_CENTER : PdfFormField.Q_LEFT);// 替換原字段
form.removeField(key);
stamper.addAnnotation(field, 1);

3. 處理圖片字段

// 獲取圖片位置信息
int pageNo = form.getFieldPositions(key).get(0).page;
Rectangle signRect = form.getFieldPositions(key).get(0).position;// 創建圖片對象
Image image = createPdfImage(imageObj);
image.scaleToFit(signRect.getWidth(), signRect.getHeight());
image.setAbsolutePosition(x, y);// 添加圖片到PDF
PdfContentByte under = stamper.getOverContent(pageNo);
under.addImage(image);

完整實現步驟

1. 加載PDF模板：使用PdfReader讀取模板文件

2. 準備輸出流：創建FileOutputStream或ByteArrayOutputStream

3. 創建PdfStamper：用于修改PDF內容

4. 獲取表單域：通過AcroFields訪問表單字段

5. 設置字體：解決中文顯示問題

6. 填充文本數據：遍歷數據Map并設置字段值

7. 處理圖片數據：計算位置并插入圖片

8. 設置表單狀態：setFormFlattening決定是否鎖定表單

9. 保存輸出：關閉stamper并輸出結果

中文顯示問題解決方案

處理PDF中文顯示是常見挑戰，以下是幾種解決方案：

方案1：使用系統字體

BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.EMBEDDED);

方案2：使用自定義字體文件

BaseFont.createFont("font/simsun.ttf", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);

跨平臺兼容處理

BaseFont bfChinese;
if(isWindowsSystem()){bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.EMBEDDED);
} else {bfChinese = BaseFont.createFont("font/simhei.ttf", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
}

圖片處理技巧

iText支持多種圖片源：

• 文件路徑

• BufferedImage對象

• 字節數組

private static Image createPdfImage(Object imageObj) throws Exception {if (imageObj instanceof String) {return Image.getInstance((String) imageObj);} else if (imageObj instanceof BufferedImage) {BufferedImage bufferedImage = (BufferedImage) imageObj;ByteArrayOutputStream baos = new ByteArrayOutputStream();ImageIO.write(bufferedImage, "png", baos);return Image.getInstance(baos.toByteArray());} else if (imageObj instanceof byte[]) {return Image.getInstance((byte[]) imageObj);} else {throw new IllegalArgumentException("不支持的圖片類型");}
}

最佳實踐

1. 資源管理：確保正確關閉所有流和reader

2. 錯誤處理：捕獲并記錄可能出現的異常

3. 性能優化：對于批量處理，考慮重用某些對象

4. 表單設計：提前規劃好表單字段命名規范

5. 日志記錄：記錄關鍵操作便于調試

常見問題解決

1. 中文顯示為空白：檢查字體是否正確設置和嵌入

2. 字段無法填充：確認字段名稱匹配且PDF是可填寫的表單

3. 圖片位置不正確：仔細檢查坐標計算邏輯

4. 內存泄漏：確保所有資源都被正確關閉

結語

通過本文介紹的方法，您可以使用Java和iText庫高效地實現PDF表單的自動化填充。無論是簡單的文本字段還是復雜的圖片和格式要求，iText都提供了強大的支持。根據實際需求選擇合適的實現方式，可以大大提高PDF處理的自動化程度和工作效率。

完整的示例代碼已在文章中展示，您可以根據自己的需求進行調整和擴展。希望這篇指南能幫助您更好地理解和應用PDF表單處理技術！