基于iText的PDF表单字段填充代码解析及技术咨询

让我来拆解这段iText代码的执行逻辑，帮你搞懂它是怎么搞定PDF表单填充的：

首先先把补全笔误后的完整可参考代码格式化出来：

try {
    // 假设reader已初始化，指向待修改的源PDF文件
    PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(outname));
    AcroFields fields = stamper.getAcroFields();
    
    // 注释掉的是错误用法：get方法用于读取字段值，设置值要用setField
    // fields.get("Your Company Name:", "Changed");
    // fields.get("Project Notes:", "Changed");
    
    // 给指定表单字段设置填充内容
    fields.setField("Your Company Name:", "Changed");
    fields.setField("Project Notes:", "Blah...Blah");
    
    // 遍历所有表单字段，打印字段名与对应值（用于验证填充结果）
    Set<String> fldNames = fields.getFields().keySet();
    for (String fldName : fldNames) {
        System.out.println(fldName + ": " + fields.getField(fldName));
    }
    
    // 关闭stamper，确保修改写入输出文件并释放资源
    stamper.close();
} catch (Exception e) {
    // 实际项目中记得处理异常
    e.printStackTrace();
}

接下来一步步拆解执行逻辑：

• 初始化PdfStamper：这是修改现有PDF的核心操作，PdfStamper接收两个参数：一个已打开的PdfReader（指向你要填充的源PDF），一个FileOutputStream（指向填充后输出的目标文件路径outname）。它的作用是加载源PDF内容，准备接受修改。

• 获取AcroFields对象：通过stamper.getAcroFields()拿到PDF表单字段的操作入口，不管是读取字段值、设置字段值，还是获取所有字段列表，都要通过这个对象完成。

• 设置表单字段值：用setField(String fieldName, String value)方法填充内容，这里有两个关键注意点：

  • 字段名必须和PDF里定义的表单字段名完全匹配（包括大小写、冒号这类符号，比如代码里的"Your Company Name:"），如果名字写错，填充会静默失败，不会抛出异常，所以填充不生效时先检查字段名是否正确。
  • 代码里注释掉的fields.get(...)是典型误区，get方法是用来读取字段值的，不是设置值。

• 遍历验证字段：通过fields.getFields().keySet()拿到所有表单字段的名称集合，循环遍历打印字段名和当前值，这一步主要用来验证填充是否成功，或者快速查看目标PDF包含哪些表单字段。

• 关闭PdfStamper：最后必须调用stamper.close()，这一步会把所有修改写入输出文件，同时释放占用的资源，不关闭可能导致输出文件损坏或资源泄漏。

额外补充几个实用注意点：

• 要确保PdfReader对象正确初始化（通常是PdfReader reader = new PdfReader("源PDF路径");）。
• 如果需要让填充后的表单不可编辑，可以在关闭stamper前调用stamper.setFormFlattening(true);，表单字段会变成普通文本，无法再修改。

内容的提问来源于stack exchange，提问作者nbrown