Сохранить аннотированный PDF с помощью GroupDocs.Annotation для Java

Расширение Java‑приложений возможностями аннотирования документов — мощный способ улучшить совместную работу, соответствие требованиям и пользовательский опыт. В этом руководстве вы узнаете как сохранять аннотированные PDF файлы с помощью GroupDocs.Annotation для Java, от настройки зависимости Maven до добавления нескольких аннотаций и соблюдения лучших практик аннотирования Java. Давайте пройдем каждый шаг, чтобы вы могли уверенно интегрировать эту функцию в свои проекты.

Быстрые ответы

Какова основная цель GroupDocs.Annotation?
Программно создавать, редактировать и сохранять аннотированные PDF документы в Java‑приложениях.
Какой Maven‑артефакт мне нужен?
com.groupdocs:groupdocs-annotation (см. раздел maven dependency groupdocs).
Можно ли добавить более одной аннотации за раз?
Да — вы можете добавлять несколько аннотаций за одну операцию.
Как инициализировать аннотатор?
Используйте шаблон initialize annotator java, показанный в руководстве.
Каковы ключевые рекомендации по лучшим практикам?
Следуйте чек‑листу annotation best practices java для управления памятью и производительностью.

Что такое «сохранить аннотированный PDF»?

Сохранение аннотированного PDF означает сохранение всех визуальных заметок — выделений, комментариев, фигур и других разметок — в PDF‑файл, чтобы любой, открывающий документ, мог увидеть изменения. GroupDocs.Annotation предоставляет простой API для выполнения этой задачи программно.

Почему использовать GroupDocs.Annotation для Java?

Кроссплатформенная поддержка — работает на любой ОС, где запущен Java.
Богатый набор типов аннотаций — от простых выделений до сложных фигур, таких как эллипсы.
Не требуется внешних PDF‑редакторов — все операции выполняются внутри вашего Java‑кода.
Масштабируемость для предприятий — подходит для юридических, образовательных и технических документооборотных процессов.

Предварительные требования

Java SDK (JDK 8 или новее), установленный на вашем компьютере.
Maven для управления зависимостями.
IDE, например IntelliJ IDEA или Eclipse.
Базовые знания программирования на Java.

Maven‑зависимость GroupDocs

Добавьте репозиторий GroupDocs и библиотеку аннотаций в ваш 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>

Приобретение лицензии

Бесплатная пробная версия: Скачайте пробную версию, чтобы протестировать GroupDocs.Annotation.
Временная лицензия: Получите временную лицензию для полного доступа во время оценки.
Покупка: Приобретите полную лицензию для использования в продакшене.

Инициализация Annotator Java

Первый шаг — initialize annotator java с документом, с которым вы хотите работать. Ниже показан базовый шаблон инициализации:

import com.groupdocs.annotation.Annotator;

public class Feature1 {
    public void loadAnnotator(String fileName) {
        try (final Annotator annotator = new Annotator(fileName)) {
            // Ready to use!
        }
    }
}

Функция 1: Загрузка и инициализация Annotator

Эта функция демонстрирует инициализацию Annotator с путем к файлу документа, настройку вашего Java‑приложения для задач аннотирования.

import com.groupdocs.annotation.Annotator;

public class Feature1 {
    public void loadAnnotator(String fileName) {
        try (final Annotator annotator = new Annotator(fileName)) {
            // Annotator initialized and ready.
        }
    }
}

Создание аннотаций

Функция 2: Создание Area Annotation

Area‑аннотации позволяют выделять прямоугольные области. Следуйте этим шагам, чтобы создать одну:

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

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

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

        area.setBackgroundColor(65535);

        area.setPageNumber(1);

        return area;
    }
}

Функция 3: Создание Ellipse Annotation

Ellipse‑аннотации идеально подходят для круглых или овальных выделений.

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

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

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

        ellipse.setBackgroundColor(123456);

        ellipse.setPageNumber(2);

        return ellipse;
    }
}

Добавление нескольких аннотаций

Вы можете добавлять несколько аннотаций за один вызов, что повышает производительность и упрощает код.

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);
    }
}

Сохранение документа — Как сохранить аннотированный PDF

Теперь, когда ваши аннотации добавлены, вы сохраните аннотированный PDF только с нужными типами аннотаций.

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

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

        annotator.save(outputPath, saveOptions);
    }
}

Лучшие практики аннотирования Java

Используйте try‑with‑resources для автоматического закрытия Annotator и освобождения памяти.
Пакетное добавление аннотаций (как показано в Функции 4) для снижения нагрузки ввода‑вывода.
Указывайте только необходимые типы аннотаций в SaveOptions, чтобы уменьшить размер файла.
Освобождайте большие документы из памяти после сохранения, чтобы избежать утечек.

Практические применения

Обзор юридических документов: Выделяйте пункты и прикрепляйте комментарии для юристов.
Образовательные ресурсы: Аннотируйте учебники для учебных групп.
Технические руководства: Помечайте инженерные чертежи заметками и предупреждениями.

Соображения по производительности

Ограничьте одновременное аннотирование очень больших PDF.
Используйте рекомендованные annotation best practices java для эффективного управления памятью.
Профилируйте приложение с помощью Java Flight Recorder, если замечаете замедления.

Распространённые проблемы и решения

Проблема	Решение
OutOfMemoryError при загрузке больших PDF	Загружайте документ в режиме потоковой передачи или увеличьте размер кучи JVM.
Аннотации не отображаются после сохранения	Убедитесь, что `SaveOptions` включает правильный `AnnotationType`.
Ошибки лицензии	Проверьте, что файл пробной или постоянной лицензии правильно указан.

Часто задаваемые вопросы

В: Можно ли добавить текстовые комментарии помимо фигур?
О: Да, GroupDocs.Annotation поддерживает типы TextAnnotation и CommentAnnotation — просто создайте соответствующую модель и добавьте её в список.

В: Можно ли редактировать существующую аннотацию?
О: Конечно. Получите аннотацию по её ID, измените свойства и вызовите annotator.update(updatedAnnotation).

В: Как удалить аннотацию, которая больше не нужна?
О: Используйте annotator.delete(annotationId) для удаления конкретной аннотации или annotator.clear(pageNumber) для очистки всех аннотаций на странице.

В: Работает ли библиотека с PDF, защищёнными паролем?
О: Да. Укажите пароль при создании экземпляра Annotator: new Annotator(filePath, password).

В: Какая версия Java требуется?
О: Библиотека совместима с Java 8 и новее; рекомендуется использовать последнюю LTS‑версию для лучшей производительности.

Заключение

Теперь у вас есть полное решение «от начала до конца» для сохранения аннотированных PDF файлов с помощью GroupDocs.Annotation для Java. Следуя описанным шагам — настройке Maven‑зависимости, инициализации аннотатора, созданию и добавлению нескольких аннотаций и применению лучших практик аннотирования — вы сможете обогатить любое Java‑приложение мощными возможностями разметки документов.

Последнее обновление: 2025-12-17
Тестировано с: GroupDocs.Annotation 25.2
Автор: GroupDocs