Був час, коли ми обговорювали вміст документів і відгуки в довгих ланцюжках електронної пошти з кількома вкладеннями та різними версіями файлів. Тепер ми можемо просто використовувати анотації, щоб розмітити документ повідомленнями та відповідями та надіслати його. У цій статті ви дізнаєтеся, як програмно коментувати PDF-документи на Java за допомогою програми. Крім того, ми побачимо, як видалити анотації з PDF-файлів за допомогою того самого Java API.
Нижче наведено теми, які коротко обговорюються:
- Java API для роботи з анотаціями в PDF
- Додайте анотації до PDF на Java
- Видалити анотації з PDF-файлу в Java
Java API анотатора PDF
Щоб працювати з анотаціями вашого документа та зображень у ваших програмах Java, GroupDocs надає GroupDocs.Annotation for Java. Використовуючи API, ви можете додавати, видаляти та витягувати анотації з текстових документів, електронних таблиць, презентацій, зображень, повідомлень електронної пошти, креслень Visio, деяких форматів AutoCAD і цифрових зображень, таких як DICOM. Крім того, API дозволяє коментувати файли PDF. Ви можете переглянути документацію, щоб дізнатися про довгий список підтримуваних форматів документів для анотацій.
Завантажте та налаштуйте
Отримайте бібліотеку анотацій із завантажень або просто додайте наступну конфігурацію pom.xml у свої програми Java на основі Maven, щоб спробувати приклади цієї статті, а також багато інших прикладів, доступних на GitHub. Щоб отримати докладніші відомості, ви можете відвідати Довідник API.
<repository>
<id>GroupDocsJavaAPI</id>
<name>GroupDocs Java API</name>
<url>http://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-annotation</artifactId>
<version>20.2</version>
</dependency>
Додайте анотації до PDF на Java
Давайте швидко перейдемо до додавання різних типів анотацій до документа PDF. Оскільки існує багато різних типів анотацій, ми можемо не розглянути всі в цій статті. Я лише згадаю їх, а ви можете дізнатися про кожну анотацію окремо.
-
Анотація площі / прямокутника
-
Стрілка
-
Відстань
-
Еліпс
-
Виділіть
-
Посилання
-
точка
-
Ломана лінія
-
Заміна
-
Редакція ресурсу
-
Викреслити
-
Текстове поле
-
Редакція тексту
-
Підкреслити
-
Водяний знак
Давайте почнемо додавати деякі з них у PDF-документ.
Додайте анотацію зі стрілкою до PDF за допомогою Java
Нижче наведено кроки, щоб додати анотацію зі стрілкою до документа PDF.
- Завантажте PDF-документ за допомогою класу Annotator.
- Ініціалізуйте анотацію стрілки за допомогою класу ArrowAnnotation.
- Встановіть положення та розмір стрілки за допомогою методу setBox ArrowAnnotation.
- Додайте створену анотацію стрілки до об’єкта Annotator.
- Збережіть анотований PDF, вказавши шлях за допомогою методу save.
У наведеному нижче прикладі коду показано, як додати анотацію зі стрілкою до документа PDF за допомогою Java.
// Додайте анотацію зі стрілкою до PDF за допомогою Java
final Annotator annotator = new Annotator("document.pdf");
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(100, 100, 100, 100)); // (x, y, width, height)
annotator.add(arrow);
annotator.save("path/annotated-with-arrow.pdf");
Вставте анотацію прямокутника або області в PDF за допомогою Java
Ви можете налаштувати будь-яку анотацію, додаючи її до документа. Нижче наведено кроки, щоб додати анотацію прямокутника або області до PDF-документа з деякими додатковими налаштуваннями. Це схоже на додавання анотації Arrow, але замість ArrowAnnotation використовується клас AreaAnnotation.
- Завантажте PDF-документ за допомогою класу Annotator.
- Ініціалізуйте анотацію прямокутника за допомогою класу AreaAnnotation.
- Встановіть положення та розмір прямокутника за допомогою методу setBox AreaAnnotation.
- Встановіть інші властивості, як-от колір, фон, непрозорість, стиль, ширину пера або навіть повідомлення та час.
- Додайте створену прямокутну анотацію до об’єкта Annotator.
- Збережіть анотований PDF, вказавши шлях за допомогою методу save.
У наведеному нижче прикладі коду показано, як додати анотацію прямокутника/області до документа PDF за допомогою Java.
// Додайте анотацію області або анотацію прямокутника до PDF за допомогою Java
final Annotator annotator = new Annotator("document.pdf");
AreaAnnotation area = new AreaAnnotation();
area.setBox(new Rectangle(50, 100, 500, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("Annotate documents and images.");
area.setOpacity(0.7);
area.setPenColor(-13076963);
area.setPenStyle(PenStyle.Dash);
area.setPenWidth((byte) 3);
// додати до документа
annotator.add(area);
annotator.save("path/annotated-with-rectangle.pdf");
Додайте овал або еліпс анотації до PDF за допомогою Java
Нижче наведено кроки для додавання овальної або еліптичної анотації до документа PDF.
- Завантажте PDF-документ за допомогою класу Annotator.
- Ініціалізуйте анотацію еліпса за допомогою класу EllipseAnnotation.
- Встановіть положення та розмір еліпса за допомогою методу setBox EllipseAnnotation.
- Додайте створену анотацію еліпса до об’єкта Annotator.
- Збережіть анотований PDF, вказавши шлях за допомогою методу save.
У наведеному нижче прикладі коду показано, як додати овальні або еліптичні анотації до документа PDF за допомогою Java.
// Додайте овальну або еліпсову анотацію в PDF за допомогою Java
final Annotator annotator = new Annotator("document.pdf");
// Овальна або еліпсова анотація
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBox(new Rectangle(275, 505, 300, 80));
// додати до документа
annotator.add(area);
annotator.save("path/annotated-with-ellipse.pdf");
Вставте анотацію про відстань у PDF за допомогою Java
Ви також можете додати анотацію відстані, щоб показати відстань між двома точками. Нижче наведено кроки, щоб додати анотацію відстані до документа PDF.
- Завантажте PDF-документ за допомогою класу Annotator.
- Ініціалізуйте анотацію відстані за допомогою класу DistanceAnnotation.
- Встановіть розмір і положення анотації за допомогою методу setBox DistanceAnnotation.
- Додайте створену анотацію відстані до об’єкта Annotator.
- Збережіть анотований PDF, вказавши шлях за допомогою методу save.
У наведеному нижче прикладі коду показано, як додати анотацію відстані до документа PDF за допомогою Java.
// Анотація відстані за допомогою Java
final Annotator annotator = new Annotator("document.pdf");
// Анотація відстані
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(775, 235, 0, 150));
// додати до документа
annotator.add(area);
annotator.save("path/annotated-with-distance.pdf");
Повний код
Підводячи підсумок, ось код Java із результатом, що показує всі додані анотації та повідомлення з відповідями, використовуючи згаданий код Java.
Наведений нижче код додає стрілку, прямокутник, еліпс, анотації відстані, повідомлення та відповіді до файлу PDF.
// Додайте кілька анотацій до PDF за допомогою Java
// Додавання анотацій зі стрілками, площами, овалами (еліпсами), відстанями до PDF із повідомленнями та відповідями за допомогою Java
final Annotator annotator = new Annotator(Constants.INPUT);
// Налаштування відповідей
Reply reply1 = new Reply();
reply1.setComment("Please look in to these issues.");
reply1.setRepliedOn(Calendar.getInstance().getTime());
Reply reply2 = new Reply();
reply2.setComment("Change Description");
reply2.setRepliedOn(Calendar.getInstance().getTime());
Reply reply3 = new Reply();
reply2.setComment("On-Premises APIs");
reply2.setRepliedOn(Calendar.getInstance().getTime());
Reply reply4 = new Reply();
reply2.setComment("Add images as well.");
reply2.setRepliedOn(Calendar.getInstance().getTime());
java.util.List<Reply> replies = new ArrayList<Reply>();
replies.add(reply1);
replies.add(reply2);
replies.add(reply3);
replies.add(reply4);
// Анотація зі стрілкою ===================================
ArrowAnnotation arrow = new ArrowAnnotation();
arrow.setBox(new Rectangle(560, 250, 60, -60));
arrow.setCreatedOn(Calendar.getInstance().getTime());
arrow.setMessage("This image is little upwards.");
arrow.setOpacity(0.7);
arrow.setPenColor(-3407872);
arrow.setPenWidth((byte) 2);
arrow.setReplies(replies.subList(0, 1));
// Анотація області =====================================
AreaAnnotation area = new AreaAnnotation();
area.setBox(new Rectangle(50, 100, 500, 100));
area.setCreatedOn(Calendar.getInstance().getTime());
area.setMessage("Annotate documents and images.");
area.setOpacity(0.7);
area.setPenColor(-13076963);
area.setPenStyle(PenStyle.Dash);
area.setPenWidth((byte) 3);
area.setReplies(replies.subList(1, 2));
// Овальна або еліпсова анотація =========================
EllipseAnnotation ellipse = new EllipseAnnotation();
ellipse.setBox(new Rectangle(275, 505, 300, 80));
ellipse.setCreatedOn(Calendar.getInstance().getTime());
ellipse.setMessage("Shows all the available Annotation APIs.");
ellipse.setOpacity(0.7);
ellipse.setPenColor(-16034924);
ellipse.setPenStyle(PenStyle.Dot);
ellipse.setPenWidth((byte) 3);
ellipse.setReplies(replies.subList(2, 3));
// Анотація відстані ================================
DistanceAnnotation distance = new DistanceAnnotation();
distance.setBox(new Rectangle(775, 235, 0, 150));
distance.setCreatedOn(Calendar.getInstance().getTime());
distance.setMessage("This is the heading area");
distance.setOpacity(0.7);
distance.setPenColor(-21197);
distance.setPenStyle(PenStyle.Solid);
distance.setPenWidth((byte) 1);
distance.setReplies(replies.subList(3, 4));
// Додавання анотацій ===================================
annotator.add(arrow);
annotator.add(area);
annotator.add(ellipse);
annotator.add(distance);
// Збереження анотованого PDF ================================
annotator.save(outputPath);
annotator.dispose();
Видалити анотації з PDF-файлу в Java
Наступні кроки показують, як видалити всі анотації з PDF-файлів у Java.
- Завантажте PDF-документ за допомогою класу Annotator.
- Ініціалізувати параметри збереження за допомогою класу SaveOptions.
- Встановіть для типів анотацій значення «Немає».
- Збережіть PDF-файл, видаливши всі анотації, вказавши шлях за допомогою методу save.
Наведений нижче код Java видаляє анотації з PDF-файлу.
// Видаліть усі анотації з документа PDF за допомогою Java
final Annotator annotator = new Annotator("document.pdf");
SaveOptions saveOptions = new SaveOptions();
saveOptions.setAnnotationTypes(AnnotationType.None);
// Збережіть PDF без анотацій.
annotator.save("path/annotations-removed.pdf", saveOptions);
annotator.dispose();
Висновок
Коротше кажучи, ви дізналися, як додавати анотації до PDF-файлів у програмах Java. Крім того, ви бачили, як видалити всі анотації з будь-якого файлу PDF. Тепер ви повинні бути впевнені, щоб створити власну програму Java для анотаторів документів. Він може підтримувати різні типи анотацій за допомогою GroupDocs.Annotation for Java.
Щоб отримати додаткові відомості, параметри та приклади, ви можете відвідати документацію і репозиторій GitHub. Щоб отримати додаткові запитання, зверніться до служби підтримки на форумі.