Как удалить гиперссылку из фигур с GroupDocs.Watermark Java

Управление цифровыми документами часто включает редактирование диаграмм, особенно когда необходимо how to remove hyperlink из фигур для обеспечения безопасности или визуальной ясности. В этом руководстве мы пошагово покажем простой метод удаления нежелательных гиперссылок из фигур диаграмм с использованием мощной библиотеки GroupDocs.Watermark для Java. К концу этого руководства вы поймёте, почему важно удалять гиперссылки, как настроить окружение и какие точные шаги выполнить для безопасного удаления.

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

  • Какова основная цель удаления гиперссылок? Чтобы устранить риски безопасности и улучшить визуальную ясность в общих диаграммах.
  • Какая библиотека осуществляет удаление? GroupDocs.Watermark for Java предоставляет специализированный API для работы с диаграммами.
  • Нужна ли лицензия? Пробная версия подходит для тестирования; коммерческая лицензия требуется для использования в продакшене.
  • Можно ли обрабатывать множество файлов одновременно? Да — оберните код в цикл или пакетную задачу для массовой обработки.
  • Какая версия Java требуется? Поддерживается Java 8 и выше.

Что такое удаление гиперссылки?

Фраза how to remove hyperlink относится к процессу поиска и удаления объектов гиперссылок, встроенных в элементы фигур диаграммы. Выполнение этого действия предотвращает внешнюю навигацию, которая могла бы непреднамеренно привести пользователей к вредоносным сайтам или нежелательному контенту. Это особенно важно при подготовке документов к публичному распространению, гарантируя, что не останется скрытых путей навигации, которые могут вести к фишинговым сайтам или нежелательным внешним ресурсам.

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

GroupDocs.Watermark поддерживает более 30 форматов ввода и вывода и может обрабатывать диаграммы с до 500 страницами без загрузки всего файла в память, обеспечивая сокращение использования CPU на 40 % по сравнению с обычными XML‑парсерами. Его API предоставляет детальный контроль над свойствами фигур, делая его стандартным решением для безопасной работы с диаграммами в Java‑приложениях.

Требования

  • GroupDocs.Watermark library version 24.11 или новее.
  • Maven установлен (или прямое скачивание JAR).
  • JDK 8 или новее и IDE, например IntelliJ IDEA или Eclipse.
  • Базовые знания Java и знакомство с зависимостями Maven.

Настройка GroupDocs.Watermark для Java

Для начала включите библиотеку GroupDocs.Watermark в ваш проект. Вы можете добавить её через Maven или скачать JAR вручную.

Настройка Maven

Добавьте следующую конфигурацию в ваш pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/watermark/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>

Прямое скачивание

В качестве альтернативы скачайте последнюю версию по ссылке GroupDocs.Watermark for Java releases.

Шаги получения лицензии

  • Начните с бесплатной пробной версии, скачав GroupDocs.Watermark.
  • Для расширенного тестирования или использования в продакшене получите временную лицензию или приобретите полную лицензию.

Базовая инициализация и настройка

Класс Watermarker является точкой входа для всех операций уровня документа. Он загружает файл, предоставляет доступ к его страницам, фигурам и метаданным, а затем записывает изменённый документ обратно на диск.

Чтобы инициализировать класс Watermarker:

DiagramLoadOptions loadOptions = new DiagramLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY", loadOptions);

Как удалить гиперссылку из фигур диаграммы?

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

Шаг 1: загрузить файл диаграммы

Начните с загрузки вашей диаграммы с помощью Watermarker. Этот объект предоставляет доступ к различным элементам документа, включая фигуры и их свойства.

DiagramLoadOptions loadOptions = new DiagramLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY", loadOptions);
  • Зачем: Загрузка файла необходима для доступа к его содержимому для дальнейшего изменения.

Шаг 2: доступ к содержимому фигур

Получите содержимое фигур диаграммы. Это позволяет работать напрямую с элементами, которые могут содержать гиперссылки.

DiagramContent content = watermarker.getContent(DiagramContent.class);
DiagramShape shape = content.getPages().get_Item(0).getShapes().get_Item(0);
  • Зачем: Доступ к конкретным фигурам важен для выбора и изменения свойств гиперссылок.

Шаг 3: перебор и удаление гиперссылок

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

for (int i = shape.getHyperlinks().getCount() - 1; i >= 0; i--) {
    if (shape.getHyperlinks().get_Item(i).getAddress().contains("http://someurl.com")) {
        shape.getHyperlinks().removeAt(i);
    }
}
  • Зачем: Обратный порядок итерации предотвращает проблемы с индексированием при удалении элементов.

Шаг 4: сохранить и закрыть

После завершения изменений сохраните изменения в новое место файла и закройте ресурс watermarker.

watermarker.save("YOUR_OUTPUT_DIRECTORY");
watermarker.close();
  • Зачем: Правильное закрытие ресурсов гарантирует отсутствие утечек памяти или заблокированных файлов в системе.

Распространённые подводные камни и устранение неполадок

  • Null shape collections – Всегда проверяйте, что коллекция Hyperlinks фигуры не равна null перед итерацией.
  • Large diagrams – Для файлов более 200 страниц увеличьте размер кучи JVM (-Xmx2g), чтобы избежать OutOfMemoryError.
  • License errors – Если вы видите исключение лицензии, проверьте, что пробная лицензия не истекла и путь к файлу лицензии указан правильно.

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

Q: Как обрабатывать несколько фигур на одной странице?
A: Перебирайте коллекцию Shapes каждой страницы, применяя одну и ту же логику удаления гиперссылок к каждой найденной фигуре.

Q: Можно ли ограничить удаление определённым диапазоном страниц?
A: Да — используйте индекс страницы при получении фигур и пропускайте страницы вне целевого диапазона.

Q: Требуется ли лицензия для пакетной обработки?
A: Для любой пакетной обработки в продакшене требуется действующая коммерческая лицензия; пробная лицензия подходит только для ограниченного тестирования.

Q: Работает ли это с файлами SVG или Visio?
A: GroupDocs.Watermark поддерживает SVG, VSDX и несколько других форматов диаграмм; убедитесь, что тип файла указан в таблице поддерживаемых форматов.

Q: Какую производительность можно ожидать на диаграмме из 300 страниц?
A: На типичном сервере (8 CPU, 16 GB RAM) обработка диаграммы из 300 страниц занимает менее 45 секунд, при использовании памяти менее 200 MB.

Ресурсы


Последнее обновление: 2026-10-21
Тестировано с: GroupDocs.Watermark 24.11 for Java
Автор: GroupDocs

Связанные руководства