<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>
repositories {
maven {
url 'https://releases.groupdocs.com/java/repo/'
}
}
compile(group: 'com.groupdocs', name: 'groupdocs-annotation', version: '24.6')
<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>
resolvers += Resolver.url("GroupDocs Repository", url("https://releases.groupdocs.com/java/repo/"))
libraryDependencies += "com.groupdocs" % "groupdocs-annotation" % "24.6"
Java 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 сохраняет результат в оригинальном формате файла.
Формат | Описание | Аннотация |
---|---|---|
DOC | Microsoft Word® Документ 97-2003 | ✔ |
DOCX | Microsoft Word® Документ | ✔ |
DOCM | Microsoft Word® Документ с поддержкой макросов | ✔ |
DOT | Microsoft Word® Шаблон 97-2003 | ✔ |
DOTX | Microsoft Word® Шаблон | ✔ |
DOTM | Microsoft Word® Шаблон с поддержкой макросов | ✔ |
RTF | Rich Text Документ | ✔ |
ODT | OpenDocument Текст | ✔ |
XLS | Microsoft Excel® Лист 97-2003 | ✔ |
XLSX | Microsoft Excel® Лист | ✔ |
XLSM (*xlsx) | Microsoft Excel® Лист с поддержкой макросов | ✔ |
XLSB (*xlsx) | Microsoft Excel® Бинарный лист | ✔ |
ODS (*xlsx) | OpenDocument Таблица | ✔ |
PPT | Microsoft PowerPoint® Презентация 97-2003 | ✔ |
PPTX | Microsoft PowerPoint® Презентация | ✔ |
PPS | Microsoft PowerPoint® Слайд-шоу 97-2003 | ✔ |
PPSX (*pptx) | Microsoft PowerPoint® Слайд-шоу | ✔ |
ODP | OpenDocument Презентация | ✔ |
TIF, TIFF | Tagged Image File Формат (TIFF) | ✔ |
JPG, JPEG | Формат JPEG | ✔ |
PNG | Формат PNG | ✔ |
BMP | Bitmap Картинка (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 | ✔ |
VSDX | Microsoft 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.");
}
}
Version | Release Date |
---|---|
24.6 | 30 июня 2024 г. |
23.10 | 9 октября 2023 г. |
23.8 | 28 августа 2023 г. |
23.6 | 23 июня 2023 г. |
23.4 | 17 апреля 2023 г. |
23.2 | 16 апреля 2023 г. |
21.7.2 | 25 января 2022 г. |
21.7.1 | 25 января 2022 г. |
2.0.0 | 25 января 2022 г. |
19.2 | 25 января 2022 г. |
17.10 | 25 января 2022 г. |
17.10.3 | 25 января 2022 г. |
1.5.0 | 25 января 2022 г. |
21.7 | 21 июля 2021 г. |
19.7 | 19 февраля 2020 г. |
20.2 | 13 февраля 2020 г. |
19.5 | 30 мая 2019 г. |
19.4 | 15 апреля 2019 г. |
18.1 | 16 октября 2018 г. |
18.10 | 16 октября 2018 г. |
1.4.0 | 18 апреля 2018 г. |
1.6.0 | 18 апреля 2018 г. |
1.7.0 | 18 апреля 2018 г. |
1.7.1 | 18 апреля 2018 г. |
1.8.0 | 18 апреля 2018 г. |
1.8.1 | 18 апреля 2018 г. |
1.8.2 | 18 апреля 2018 г. |
1.9.0 | 18 апреля 2018 г. |
17.1.0 | 18 апреля 2018 г. |
17.10.1 | 18 апреля 2018 г. |
17.10.2 | 18 апреля 2018 г. |
17.5.0 | 18 апреля 2018 г. |
17.6.0 | 18 апреля 2018 г. |
18.4 | 18 апреля 2018 г. |
3.1.0 | 18 апреля 2018 г. |
GroupDocs.Annotation Java API Аннотирование документов Водяные знаки Управление документами Аннотирование PDF Аннотирование Word Аннотирование Excel Аннотирование PowerPoint Аннотирование изображений Поддержка OLE Управление метаданными Кроссплатформенная совместимость Текстовые аннотации Область аннотаций Разметка аннотаций Измерение расстояния Редактирование Пользовательский вид аннотаций Совместная рецензия документов Безопасность документов Сохранение метаданных Пакетная обработка Высокая производительность Масштабируемость Кроссплатформенность Печать аннотаций Microsoft Word Microsoft Excel Microsoft PowerPoint PDF JPG PNG BMP DWG DXF Visio Adobe Portable Document Format Язык гипертекстовой разметки Сообщение электронной почты Инструменты аннотирования Java Maven Интеграция API Локальный API Сравнение документов Целостность документов