<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 для 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: Бесшовная интеграция с другими продуктами 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® Шаблон с поддержкой макросов
RTFRich Text Документ
ODTOpenDocument Текст
XLSMicrosoft Excel® Лист 97-2003
XLSXMicrosoft Excel® Лист
XLSM (*xlsx)Microsoft Excel® Лист с поддержкой макросов
XLSB (*xlsx)Microsoft Excel® Бинарный лист
ODS (*xlsx)OpenDocument Таблица
PPTMicrosoft PowerPoint® Презентация 97-2003
PPTXMicrosoft PowerPoint® Презентация
PPSMicrosoft PowerPoint® Слайд-шоу 97-2003
PPSX (*pptx)Microsoft PowerPoint® Слайд-шоу
ODPOpenDocument Презентация
TIF, TIFFTagged Image File Формат (TIFF)
JPG, JPEGФормат JPEG
PNGФормат PNG
BMPBitmap Картинка (BMP)
DWG (*png)Autodesk® Формат проектных данных
DXF (*png)Формат обмена чертежами (DXF)
PDF (PDF/A-1a,PDF/A-1b,PDF/A-2a)Adobe Portable Document Формат (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 для Java поддерживает следующие операционные системы, фреймворки и менеджеры пакетов:

Поддерживаемые опции
Операционные системыMicrosoft Windows® Desktop
Microsoft Windows® Server
Linux
macOS
Поддерживаемые фреймворкиJava 7 (1.7) и выше
Среды разработкиNetBeans
IntelliJ IDEA
Eclipse
Инструмент автоматизации сборкиMaven

GroupDocs.Annotation для Java не требует установки какого-либо дополнительного программного обеспечения или сторонних инструментов. Просто следуйте одному из способов, описанных в Установка и конфигурация.

Начало работы

GroupDocs размещает все Java API в репозитории GroupDocs. Вы можете легко использовать GroupDocs.Annotation для Java API напрямую в ваших Maven проектах с простыми настройками.

Шаг 1: Укажите конфигурацию репозитория GroupDocs

Для начала вам нужно указать конфигурацию репозитория GroupDocs в вашем Maven pom.xml файле следующим образом:

<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 для Java API

Затем определите зависимость GroupDocs.Annotation для Java API в вашем pom.xml файле следующим образом:

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

 
    </dependency>
</dependencies>

Примеры кода

Пример кода 1: Добавление текстовой аннотации в PDF документ

Этот пример кода демонстрирует, как использовать GroupDocs.Annotation для 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";
        
        // Инициализируйте объект Annotator для PDF документа
        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 документа

Этот пример кода иллюстрирует, как удалить все аннотации из Microsoft Word документа (DOCX) с использованием GroupDocs.Annotation для Java. Это особенно полезно, когда вам нужно очистить документ, удалив комментарии, заметки или другие типы аннотаций.

// Импортируйте необходимые классы
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";
        
        // Инициализируйте объект Annotator для Word документа
        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

Этот пример кода демонстрирует, как извлечь комментарии и аннотации из таблицы Excel (XLSX) с использованием GroupDocs.Annotation для Java. Эта функция полезна для рецензирования и суммирования обратной связи или заметок, оставленных в документе 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";
        
        // Инициализируйте объект Annotator для Excel документа
        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.630 июня 2024 г.
23.109 октября 2023 г.
23.828 августа 2023 г.
23.623 июня 2023 г.
23.417 апреля 2023 г.
23.216 апреля 2023 г.
21.7.225 января 2022 г.
21.7.125 января 2022 г.
2.0.025 января 2022 г.
19.225 января 2022 г.
17.1025 января 2022 г.
17.10.325 января 2022 г.
1.5.025 января 2022 г.
21.721 июля 2021 г.
19.719 февраля 2020 г.
20.213 февраля 2020 г.
19.530 мая 2019 г.
19.415 апреля 2019 г.
18.116 октября 2018 г.
18.1016 октября 2018 г.
1.4.018 апреля 2018 г.
1.6.018 апреля 2018 г.
1.7.018 апреля 2018 г.
1.7.118 апреля 2018 г.
1.8.018 апреля 2018 г.
1.8.118 апреля 2018 г.
1.8.218 апреля 2018 г.
1.9.018 апреля 2018 г.
17.1.018 апреля 2018 г.
17.10.118 апреля 2018 г.
17.10.218 апреля 2018 г.
17.5.018 апреля 2018 г.
17.6.018 апреля 2018 г.
18.418 апреля 2018 г.
3.1.018 апреля 2018 г.