iText5中如何将PdfTemplate添加至PdfStamper？及PDF注释嵌入咨询

嘿，我来帮你搞定这两个iText5相关的问题：

PdfStamper的核心作用就是修改现有PDF，而PdfTemplate作为可复用的绘图容器，完全可以添加到PdfStamper处理的PDF页面中。具体实现步骤和代码示例如下：

• 首先初始化PdfStamper，关联待修改的输入PDF和输出流；
• 通过PdfStamper.getOverContent()或getUnderContent()获取目标页面的PdfContentByte；
• 用PdfContentByte.createTemplate()创建空白模板，在模板上绘制你需要的内容；
• 最后调用PdfContentByte.addTemplate()将模板添加到页面的指定坐标位置。

示例代码：

// 初始化PdfStamper
PdfReader reader = new PdfReader("input.pdf");
FileOutputStream fos = new FileOutputStream("output_with_template.pdf");
PdfStamper stamper = new PdfStamper(reader, fos);

// 获取第一页的上层内容字节对象
PdfContentByte cb = stamper.getOverContent(1);
// 创建一个100x100的空白模板
PdfTemplate template = cb.createTemplate(100, 100);

// 在模板上绘制自定义内容（这里示例画矩形+文字）
template.rectangle(0, 0, 100, 100);
template.stroke();
template.beginText();
template.setFontAndSize(BaseFont.createFont(), 12);
template.showTextAligned(Element.ALIGN_CENTER, "My Template", 50, 50, 0);
template.endText();

// 将模板添加到第一页的(100, 100)坐标处
cb.addTemplate(template, 100, 100);

// 关闭所有资源
stamper.close();
reader.close();
fos.close();

根据你的业务场景，已经完成了区域裁剪，接下来只需要把裁剪后的内容转换成注释的自定义外观，再嵌入到父PDF中即可。核心思路是把裁剪后的PDF页面导入为PdfTemplate，然后将这个模板设置为PDF注释的外观，这样注释显示的就是你需要的精确裁剪内容。具体步骤和代码示例如下：

1. 读取裁剪好的PDF文件，获取其页面尺寸；
2. 初始化父PDF的PdfStamper；
3. 创建PdfTemplate并将裁剪后的页面内容导入到模板中；
4. 创建PDF注释，设置其位置和大小，并将模板设为注释的正常外观；
5. 将注释添加到父PDF的指定页面。

示例代码：

// 1. 读取裁剪后的PDF（假设仅包含一页裁剪好的内容）
PdfReader croppedReader = new PdfReader("cropped_area.pdf");
Rectangle croppedSize = croppedReader.getPageSize(1);

// 2. 初始化父PDF的PdfStamper
PdfReader parentReader = new PdfReader("parent.pdf");
FileOutputStream outputStream = new FileOutputStream("parent_with_annotation.pdf");
PdfStamper parentStamper = new PdfStamper(parentReader, outputStream);

// 3. 创建模板并导入裁剪后的页面内容
PdfContentByte parentCb = parentStamper.getOverContent(1); // 选择要添加注释的父页面
PdfTemplate annotTemplate = parentCb.createTemplate(croppedSize.getWidth(), croppedSize.getHeight());
// 将裁剪后的页面导入到模板中
annotTemplate.addTemplate(parentCb.getImportedPage(croppedReader, 1), 0, 0);

// 4. 创建自定义外观的注释
// 设置注释在父PDF上的位置（示例为坐标(200,200)，大小和裁剪区域一致）
float annotX = 200;
float annotY = 200;
Rectangle annotRect = new Rectangle(annotX, annotY, annotX + croppedSize.getWidth(), annotY + croppedSize.getHeight());

// 创建一个基础文本注释，然后替换其外观为我们的模板
PdfAnnotation annotation = PdfAnnotation.createText(
    parentStamper.getWriter(), annotRect, "Cropped Content", 
    "This is the cropped area from the exported PDF", false, ""
);
// 设置注释的正常显示外观为我们的模板
annotation.setAppearance(PdfName.N, annotTemplate);
// 可选：设置注释为只读，避免用户修改外观
annotation.setFlags(PdfAnnotation.FLAGS_READ_ONLY);

// 5. 将注释添加到父PDF的第一页
parentStamper.addAnnotation(annotation, 1);

// 关闭所有资源
parentStamper.close();
parentReader.close();
outputStream.close();
croppedReader.close();

这样处理后，父PDF中的注释外观就和你裁剪的区域完全一致了，而且位置和大小都可以精确控制。

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