PDF表单是企业和机构常用的数据收集工具，而通过编程方式自动填充PDF表单可以大大提高工作效率。本文将详细介绍如何使用Java和iText库来实现PDF表单的自动化填充。

为什么选择iText库？

iText是一个强大的PDF操作库，具有以下优势：

功能全面，支持PDF创建、编辑和填充
性能优异，适合处理大量PDF文档
支持复杂的PDF操作如表单填充、数字签名等
活跃的社区支持和良好的文档

环境准备

在开始之前，请确保：

项目中已添加iText依赖（Maven配置如下）

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

准备好PDF表单模板（确保是可填写的PDF表单），具体可以查看使用Adobe Acrobat DC创建PDF表单域的完整指南-CSDN博客
准备好要填充的数据

核心代码解析

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);

完整实现步骤

加载PDF模板：使用PdfReader读取模板文件
准备输出流：创建FileOutputStream或ByteArrayOutputStream
创建PdfStamper：用于修改PDF内容
获取表单域：通过AcroFields访问表单字段
设置字体：解决中文显示问题
填充文本数据：遍历数据Map并设置字段值
处理图片数据：计算位置并插入图片
设置表单状态：setFormFlattening决定是否锁定表单
保存输出：关闭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("不支持的图片类型");}
}