<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/java/repo/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-annotation</artifactId>
      <version>24.6</version>
   </dependency>
</dependencies>
copied!  
repositories {
    maven {
        url 'https://releases.groupdocs.com/java/repo/'
    }
}

compile(group: 'com.groupdocs', name: 'groupdocs-annotation', version: '24.6')
copied!  
<ivysettings>
    <settings defaultResolver="chain"/>
    <resolvers>
        <chain name="chain">
            <ibiblio name="GroupDocs Repository" m2compatible="true" root="https://releases.groupdocs.com/java/repo/"/>
        </chain>
    </resolvers>
</ivysettings>

<dependency org="com.groupdocs" name="groupdocs-annotation" rev="24.6">
   <artifact name="groupdocs-annotation" ext="jar"/>
</dependency>
copied!  
resolvers += Resolver.url("GroupDocs Repository", url("https://releases.groupdocs.com/java/repo/"))

libraryDependencies += "com.groupdocs" % "groupdocs-annotation" % "24.6"
copied!  

文档注释 Java 高级代码 API

产品 文档 演示 API 参考 示例 博客 支持 许可证

GroupDocs.Annotation for Java 是一个强大的本地 API,专为 Java 开发人员设计,可用于注释、添加水印和管理各种格式的文档,如 PDF、Word®、Excel®、PowerPoint® 和图像。它提供了包括文本、区域和图像注释、OLE 支持、元数据管理和跨平台兼容性在内的高级功能。

文档注释 Java 本地 API 特性

文档和格式支持

  • 支持多种文档格式: 注释多种文档格式,包括 PDF、Word®、Excel®、PowerPoint®、Visio® 和图像(JPG、PNG、BMP 等)。
  • PDF 特定注释: 支持粘性便笺、文本字段和其他 PDF 特定注释类型。
  • 支持图像格式: 注释流行的图像格式,包括 JPG、PNG、BMP 等。
  • 注释导出格式: 将注释导出为不同格式以实现互操作性。
  • OLE 支持: 支持在注释文档中使用 OLE 对象。
  • 与其他 GroupDocs API 的兼容性: 与其他 GroupDocs 产品无缝集成,以扩展功能。

注释类型和工具

  • 文本注释: 添加文本注释,如高亮、下划线和删除线。
  • 区域注释: 使用矩形、多边形和点注释突出显示并评论特定区域。
  • 标记注释: 应用标记注释,如涂黑以隐藏敏感内容。
  • 距离测量: 测量文档中对象之间的距离,适用于技术图纸和 CAD 文件。
  • 水印: 添加文本和图像水印,以实现品牌或安全目的。
  • 图像注释: 注释图像文件,支持多种图像格式。

注释管理

  • 注释回复: 允许多个用户回复注释,实现协作文档审查。
  • 自定义注释外观: 自定义注释外观,包括颜色、字体和不透明度设置。
  • 导出/导入注释: 将注释导出到外部文件,并重新导入以进行共享或协作。
  • 注释分层: 控制注释的分层,使注释可以重叠或保持独立。
  • 注释处理: 能够以编程方式创建、编辑和删除注释。
  • 注释元数据: 在注释文档的同时保持元数据的完整性。
  • 撤销/重做支持: 为注释操作实现撤销/重做功能。

协作和审查

  • 协作功能: 允许多个用户在同一文档上进行注释、评论和协作。
  • 文档比较: 并排比较文档或图像,以突出显示差异。
  • 注释回复: 允许多个用户回复注释,实现协作文档审查。

安全性和文档完整性

  • 文档安全性: 应用注释,以隐藏敏感信息,如涂黑。
  • 元数据管理: 管理并保护注释文档中的元数据。

搜索和导航

  • 高级搜索功能: 在注释文档中进行搜索,包括在注释中进行搜索的能力。

性能和可扩展性

  • 批处理: 同时处理多个文

档的注释,提高效率。

  • 可扩展性: 设计为能够高效处理大量文档和注释。
  • 高性能: 针对注释和文档处理进行了优化,以实现快速处理。

跨平台兼容性和集成

  • 跨平台兼容性: 可在多种操作系统上使用,包括 Windows、macOS 和 Linux。
  • 灵活集成: 轻松集成到 Java 应用程序中,提供丰富的 API 功能。

输出和展示

  • 打印和保存注释: 打印或保存文档时可选择包括或排除注释。

支持的文档格式

对于某些文件类型,GroupDocs.Annotation 会将结果保存为不同的格式。在这种情况下,输出文件类型在 * 后指定。如果没有指定此符号,GroupDocs.Annotation 会将结果保存为原始文件类型。

格式描述注释支持
DOCMicrosoft Word® 97-2003 文档
DOCXMicrosoft Word® 文档
DOCMMicrosoft Word® 启用宏的文档
DOTMicrosoft Word® 97-2003 模板
DOTXMicrosoft Word® 模板
DOTMMicrosoft Word® 启用宏的模板
RTF富文本格式文档
ODT开放文档文本
XLSMicrosoft Excel® 97-2003 工作表
XLSXMicrosoft Excel® 工作表
XLSM (*xlsx)Microsoft Excel® 启用宏的工作表
XLSB (*xlsx)Microsoft Excel® 二进制工作表
ODS (*xlsx)开放文档电子表格
PPTMicrosoft PowerPoint® 97-2003 演示文稿
PPTXMicrosoft PowerPoint® 演示文稿
PPSMicrosoft PowerPoint® 97-2003 幻灯片放映
PPSX (*pptx)Microsoft PowerPoint® 幻灯片放映
ODP开放文档演示文稿
TIF, TIFF标记图像文件格式(TIFF)
JPG, JPEG联合图像专家组(JPEG)
PNG便携式网络图形(PNG)
BMP位图图片(BMP)
DWG (*png)Autodesk® 设计数据格式
DXF (*png)绘图交换格式
PDF (PDF/A-1a,PDF/A-1b,PDF/A-2a)Adobe 便携文档格式 (PDF)
HTM (*html)超文本标记语言 (HTM)
HTML超文本标记语言 (HTML)
EML电子邮件消息 (EML)
EMLX (*eml)电子邮件消息 (EMLX)
VSD (*vsdx)Microsoft Visio® 2003-2010 绘图
VSDXMicrosoft Visio® 绘图
VSDM (*vsdx)Microsoft Visio® 绘图文件格式
VSS (*vsdx)Microsoft Visio® 2003-2010 模板
VSSX (*vsdx)Visio® 模板文件格式
VST (*vsdx)Microsoft Visio® 2013 模板
VSTM (*vsdx)Microsoft Visio® 模板文件格式

支持的注释类型

图形注释

  • 区域: 使用矩形标记区域并添加注释。
  • 箭头: 在文档中绘制箭头。
  • 距离: 测量文档中对象之间的距离。
  • 椭圆: 在文档中绘制椭圆形注释。
  • 点: 将评论附加到文档中的任何点。
  • 折线: 绘制形状和自由手线条。
  • 涂黑: 用黑色矩形填充固定位置(用于隐藏文本)。
  • 文本框: 添加带有文本的矩形。

文本注释

  • 高亮: 高亮并评论选定的文本。
  • 替换: 用用户的文本替换原始文本。
  • 删除线: 用删除线样式标记文本。
  • 下划线: 用下划线样式标记文本。

水印注释

  • 水平水印: 添加水平文本水印。
  • 对角线水印: 添加对角线文本水印。

系统要求

GroupDocs.Annotation for Java 支持以下操作系统、框架和包管理器:

支持的选项
操作系统Microsoft Windows® 桌面版
Microsoft Windows® 服务器版
Linux
MacOS
支持的框架Java 7 (1.7) 及以上
开发环境NetBeans
IntelliJ IDEA
Eclipse
构建自动化工具Maven

GroupDocs.Annotation for Java 不需要安装任何外部软件或第三方工具。只需按照 安装和配置 中描述的方法之一进行操作。

快速入门

GroupDocs 将所有 Java API 托管在 GroupDocs 仓库 中。您可以通过简单的配置,直接在您的 Maven 项目中使用 GroupDocs.Annotation for Java API。

第 1 步:指定 GroupDocs 仓库配置

首先,您需要在 Maven 的 pom.xml 文件中指定 GroupDocs 仓库配置,如下所示:

<repositories>
    <repository>
        <id>GroupDocs Artifact Repository</id>
        <name>GroupDocs Artifact Repository</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>

第 2 步:定义 GroupDocs.Annotation for Java API 依赖项

接下来,在 Maven 的 pom.xml 文件中定义 GroupDocs.Annotation for Java API 依赖项,如下所示:

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-annotation</artifactId>
        <version>23.10</version> 
    </dependency>
</dependencies>

代码示例

代码示例 1:向 PDF 文档添加文本注释

此代码段演示了如何使用 GroupDocs.Annotation for Java 向 PDF 文档添加文本注释。文本注释包括一个评论或备注,当用户将鼠标悬停在注释区域时会显示为弹出窗口。此功能对于审阅和评论 PDF 文档特别有用。

// 导入必要的类
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.models.Annotation;
import com.groupdocs.annotation.models.annotationtypes.TextAnnotation;
import com.groupdocs.annotation.options.export.AnnotationOptions;

import java.awt.Color;
import java.nio.file.Paths;

public class AddTextAnnotationToPDF {
    public static void main(String[] args) {
        // 输入 PDF 文档的路径
        String inputFilePath = "input.pdf";
        
        // 输出 PDF 文档的路径
        String outputFilePath = "output.pdf";
        
        // 初始化 PDF 文档的 Annotator 对象
        Annotator annotator = new Annotator(inputFilePath);
        
        // 创建一个新的文本注释
        TextAnnotation textAnnotation = new TextAnnotation();
        textAnnotation.setPageNumber(1); // 设置页码
        textAnnotation.setMessage("这是一个文本注释"); // 设置注释消息
        textAnnotation.setBox(new Rectangle(100, 100, 200, 50)); // 设置注释的位置和大小
        textAnnotation.setBackgroundColor(Color.yellow); // 设置注

释的背景颜色
        textAnnotation.setFontColor(Color.black); // 设置注释文本的字体颜色
        
        // 将文本注释添加到文档中
        annotator.add(textAnnotation);
        
        // 保存已注释的 PDF 文档
        annotator.save(outputFilePath, new AnnotationOptions());
        
        // 关闭 Annotator
        annotator.dispose();
        
        System.out.println("文本注释已成功添加到 PDF 文档中。");
    }
}

代码示例 2:从 Word 文档中删除注释

此代码段说明了如何使用 GroupDocs.Annotation for Java 从 Microsoft Word 文档(DOCX)中删除所有注释。这在您需要通过删除评论、备注或其他类型的注释来清理文档时特别有用。

// 导入必要的类
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.options.remove.RemoveOptions;

public class RemoveAnnotationsFromWordDocument {
    public static void main(String[] args) {
        // 输入 Word 文档的路径
        String inputFilePath = "input.docx";
        
        // 输出 Word 文档的路径
        String outputFilePath = "output.docx";
        
        // 初始化 Word 文档的 Annotator 对象
        Annotator annotator = new Annotator(inputFilePath);
        
        // 定义删除选项以删除所有注释
        RemoveOptions removeOptions = new RemoveOptions();
        
        // 从文档中删除所有注释
        annotator.remove(removeOptions);
        
        // 保存已清理的 Word 文档
        annotator.save(outputFilePath);
        
        // 关闭 Annotator
        annotator.dispose();
        
        System.out.println("所有注释已成功从 Word 文档中删除。");
    }
}

代码示例 3:从 Excel 电子表格中提取评论

此代码段展示了如何使用 GroupDocs.Annotation for Java 从 Excel 电子表格(XLSX)中提取评论和注释。此功能对于审阅和汇总 Excel 文档中留下的反馈或备注非常有用。

// 导入必要的类
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.models.AnnotationBase;
import com.groupdocs.annotation.options.export.AnnotationOptions;

import java.util.List;

public class ExtractCommentsFromExcel {
    public static void main(String[] args) {
        // 输入 Excel 文档的路径
        String inputFilePath = "input.xlsx";
        
        // 初始化 Excel 文档的 Annotator 对象
        Annotator annotator = new Annotator(inputFilePath);
        
        // 从文档中提取所有注释
        List<AnnotationBase> annotations = annotator.get();
        
        // 迭代提取的注释并打印其消息
        for (AnnotationBase annotation : annotations) {
            System.out.println("注释类型: " + annotation.getAnnotationType());
            System.out.println("注释消息: " + annotation.getMessage());
        }
        
        // 关闭 Annotator
        annotator.dispose();
        
        System.out.println("评论已成功从 Excel 电子表格中提取。");
    }
}

产品 文档 演示 API 参考 示例 博客 支持 许可证

VersionRelease Date
24.62024年6月30日
23.102023年10月9日
23.82023年8月28日
23.62023年6月23日
23.42023年4月17日
23.22023年4月16日
21.7.22022年1月25日
21.7.12022年1月25日
2.0.02022年1月25日
19.22022年1月25日
17.102022年1月25日
17.10.32022年1月25日
1.5.02022年1月25日
21.72021年7月21日
19.72020年2月19日
20.22020年2月13日
19.52019年5月30日
19.42019年4月15日
18.12018年10月16日
18.102018年10月16日
1.4.02018年4月18日
1.6.02018年4月18日
1.7.02018年4月18日
1.7.12018年4月18日
1.8.02018年4月18日
1.8.12018年4月18日
1.8.22018年4月18日
1.9.02018年4月18日
17.1.02018年4月18日
17.10.12018年4月18日
17.10.22018年4月18日
17.5.02018年4月18日
17.6.02018年4月18日
18.42018年4月18日
3.1.02018年4月18日