完整指南：使用 GroupDocs.Annotation for Java 创建和管理注释

介绍

您是否希望通过添加强大的文档注释功能来增强您的 Java 应用程序？无论您是需要突出显示关键部分还是添加详细的注释，集成像 GroupDocs.Annotation 这样的高效解决方案都可以简化各行各业的工作流程。本教程将指导您使用 GroupDocs.Annotation for Java 轻松地在文档中加载、创建和保存注释。

您将学到什么：

  • 如何使用文档初始化注释器。
  • 以编程方式创建区域和椭圆注释。
  • 向文档添加多个注释。
  • 保存具有特定注释类型的注释文档。

让我们从设置您的开发环境开始！

先决条件

在开始之前，请确保您的开发环境已正确配置：

  • 所需库：

    • GroupDocs.Annotation for Java 版本 25.2
    • Maven 用于依赖管理

  • 环境设置要求：

    • 在您的机器上安装 Java SDK。
    • 使用 IntelliJ IDEA 或 Eclipse 等 IDE 进行开发。

  • 知识前提：

    • 对 Java 编程有基本的了解。
    • 熟悉Maven构建工具。

为 Java 设置 GroupDocs.Annotation

要使用 Maven 将 GroupDocs.Annotation 集成到您的项目中，请将以下配置添加到您的 pom.xml：

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/annotation/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-annotation</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

许可证获取

  1. 免费试用： 下载试用版来测试 GroupDocs.Annotation。
  2. 临时执照： 在评估期间获取临时许可证以获得完全访问权限。
  3. 购买： 如果满意，您可以购买完整许可证。

基本初始化： 要初始化 Annotator，请通过提供文档的文件路径来创建实例：

import com.groupdocs.annotation.Annotator;

public class Feature1 {
    public void loadAnnotator(String fileName) {
        try (final Annotator annotator = new Annotator(fileName)) {
            // 准备使用！
        }
    }
}

实施指南

功能 1：加载和初始化注释器

概述： 此功能演示了如何使用文档文件路径初始化注释器，以及设置 Java 应用程序以执行注释任务。

步骤 1：初始化注释器

创建一个实例 Annotator 提供文件名。此步骤至关重要，因为它可以帮助您为文档做好进一步注释的准备。

import com.groupdocs.annotation.Annotator;

public class Feature1 {
    public void loadAnnotator(String fileName) {
        try (final Annotator annotator = new Annotator(fileName)) {
            // 注释器已初始化并准备就绪。
        }
    }
}

功能 2：创建区域注释

概述： 了解如何创建具有特定属性（例如大小、颜色和页码）的区域注释。

步骤 1：创建新 AreaAnnotation 目的

首先实例化 AreaAnnotation 班级。

import com.groupdocs.annotation.models.Rectangle;
import com.groupdocs.annotation.models.annotationmodels.AreaAnnotation;

public class Feature2 {
    public AreaAnnotation createAreaAnnotation() {
        AreaAnnotation area = new AreaAnnotation();

步骤 2：设置矩形边界

使用 Rectangle 目的。

        area.setBox(new Rectangle(100, 100, 100, 100));

步骤3：设置背景颜色

指定可见性的背景颜色。

        area.setBackgroundColor(65535);

步骤 4：指定页码

指示此注释将出现在文档的什么位置。

        area.setPageNumber(1);

        return area;
    }
}

功能 3：创建椭圆注释

概述： 此功能专注于创建椭圆注释，允许在文档中添加圆形或椭圆形注释。

步骤 1：创建新 EllipseAnnotation 目的

首先实例化 EllipseAnnotation。

import com.groupdocs.annotation.models.Rectangle;
import com.groupdocs.annotation.models.annotationmodels.EllipseAnnotation;

public class Feature3 {
    public EllipseAnnotation createEllipseAnnotation() {
        EllipseAnnotation ellipse = new EllipseAnnotation();

步骤 2：定义矩形边界

使用设置边界尺寸 Rectangle。

        ellipse.setBox(new Rectangle(100, 100, 100, 100));

步骤3：设置背景颜色

选择合适的背景颜色。

        ellipse.setBackgroundColor(123456);

步骤 4：标明页码

指定此注释的页面。

        ellipse.setPageNumber(2);

        return ellipse;
    }
}

功能 4：向 Annotator 添加注释

概述： 了解如何使用 Annotator 实例。

步骤 1：创建并添加注释

创建注释并将其添加到注释者列表。

import com.groupdocs.annotation.Annotator;
import java.util.ArrayList;
import java.util.List;
import com.groupdocs.annotation.models.AnnotationBase;
import com.groupdocs.annotation.models.annotationmodels.AreaAnnotation;
import com.groupdocs.annotation.models.annotationmodels.EllipseAnnotation;

public class Feature4 {
    public void addAnnotations(Annotator annotator) {
        AreaAnnotation area = new AreaAnnotation();
        area.setBox(new Rectangle(100, 100, 100, 100));
        area.setBackgroundColor(65535);
        area.setPageNumber(1);

        EllipseAnnotation ellipse = new EllipseAnnotation();
        ellipse.setBox(new Rectangle(100, 100, 100, 100));
        ellipse.setBackgroundColor(123456);
        ellipse.setPageNumber(2);

        List<AnnotationBase> annotations = new ArrayList<>();
        annotations.add(area);
        annotations.add(ellipse);

        annotator.add(annotations);
    }
}

功能5：保存带有特定注释的文档

概述： 了解如何保存带注释的文档，指定应保留哪些注释类型。

步骤1：指定输出路径

确定保存的文件所在的位置。

public class Feature5 {
    public String getOutputPath(String fileName) {
        return "YOUR_OUTPUT_DIRECTORY" + "/filtered_output.pdf";

步骤 2：保存带注释的文档及其选项

配置保存选项以仅包含所需的注释并执行保存过程。

    public void saveAnnotatedDocument(Annotator annotator, String outputPath) {
        SaveOptions saveOptions = new SaveOptions();
        saveOptions.setAnnotationTypes(AnnotationType.ELLIPSE);

        annotator.save(outputPath, saveOptions);
    }
}

实际应用

  • 法律文件审查： 突出显示需要注意或修改的部分。
  • 教育资源： 为学习小组注释教科书和论文。
  • 技术手册： 在工程文件中标记重要注释或说明。

集成可能性包括将注释与项目管理工具相链接以跟踪随时间的变化。

性能考虑

为确保性能平稳运行：

  • 限制大型文档的并发注释数量。
  • 通过在注释任务完成后释放资源来管理内存使用情况。
  • 实施 Java 内存管理的最佳实践，例如使用 try-with-resources 来有效地处理 Annotator 实例。

结论

通过本指南，您学习了如何使用 GroupDocs.Annotation 在 Java 中加载、创建和保存注释。此功能增强了文档工作流程，让您更轻松地突出显示重要信息、添加注释以及跨各种应用程序管理文档。