J*a如何在PDF添加注释_石家庄创泽智能科技有限公司

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

J*a如何在PDF添加注释

2025-12-05

浏览次数：次

返回列表

J*a中给PDF添加注释主流用iText 7或Apache PDFBox：iText需手动构造PdfAnnotation并设置PDF坐标系下的矩形区域，PDFBox则通过PDAnnotation子类直接添加，二者均需注意坐标系转换、中文字体嵌入及权限处理。

java如何在pdf添加注释

J*a中给PDF添加注释，主流方式是使用 iText（推荐 7.x 版本）或 Apache PDFBox。两者都支持添加文本注释（如“高亮”“下划线”“弹出式备注”）、图章、线条批注等，但 API 设计和注释类型支持略有差异。

用 iText 7 添加文本注释（如高亮、下划线）

iText 7 的注释功能封装在 pdfa 和 layout 模块之外的 kernel 层，需手动构造 PdfAnnotation 并关联到指定坐标位置（基于 PDF 坐标系，原点在左下角）。

先用 PdfDocument 打开目标 PDF，获取某页的 PdfPage
创建注释对象，例如 PdfTextAnnotation（带弹出框的文本备注）或 PdfMarkupAnnotation（高亮/下划线/删除线）
设置矩形区域（setRectangle()），必须落在页面内容区内（单位：用户单位，默认1/72英寸）
调用 page.addAnnotation() 添加；若需显示弹出框，再 add 一个 PdfPopupAnnotation 并关联

示例关键代码片段：

PdfTextAnnotation annot = new PdfTextAnnotation(new Rectangle(50, 750, 200, 50))
    .setTitle(new PdfString("作者"))
    .setContents(new PdfString("此处需补充实验数据"))
    .setOpen(true); // 默认展开弹出框
page.addAnnotation(annot);

用 PDFBox 添加简单批注（如文字备注、高亮）

PDFBox 更轻量，对基础注释支持友好。其 PDAnnotation 子类（如 PDAnnotationText、PDAnnotationHighlight）可直接添加到页面的 annotations 列表。

加载 PDF：用 PDDocument.load()
获取页面：document.getPage(0)
创建高亮注释：PDAnnotationHighlight highlight = new PDAnnotationHighlight();
设置高亮区域（COSArray 形式的四边形坐标，按顺时针顺序：x1,y1,x2,y2,...x4,y4）
设置颜色、不透明度，并添加进页面注释列表：page.getAnnotations().add(highlight)

注意：PDFBox 的高亮坐标是四点定义的多边形，不是矩形，更适合真实高亮文本轮廓；若只需矩形标注，可用 PDAnnotationSquare 或 PDAnnotationCircle。

Writer

企业级AI内容创作工具

220 查看详情 Writer

添加注释前的关键准备事项

无论用哪个库，以下几点容易被忽略但直接影响效果：

坐标系理解：PDF 页面坐标原点在左下角，y 向上增长；而屏幕或打印预览常以左上为原点——需做 y 转换：y_pdf = pageHeight - y_screen
字体与编码：中文注释内容需确保嵌入支持中文的字体（iText 中用 PdfFontFactory.createFont() 加载 NotoSansCJK；PDFBox 中设置 PDAnnotationText.setFont() 并 embed 字体流）
保存与权限：部分 PDF 启用编辑限制（如禁止注释），需先检查并移除密码或权限（PDDocument.setAllSecurityToBeRemoved(true) 或 iText 的 setEncryption() 解密）