Как добавить водяной знак в электронную таблицу Excel с помощью GroupDocs.Watermark Java SDK

Защита ваших файлов Excel от несанкционированного распространения или простое укрепление фирменного стиля может быть достигнута добавлением визуального знака, который остаётся видимым независимо от способа просмотра файла. В этом руководстве вы узнаете как добавить водяной знак — конкретно водяной знак‑изображение — в заголовок или нижний колонтитул электронной таблицы Excel с помощью GroupDocs.Watermark Java SDK. К концу руководства вы сможете внедрить логотип, значок конфиденциальности или любое пользовательское изображение непосредственно в вашу книгу без изменения данных ячеек.

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

Что означает “how to add watermark”? Добавление изображения (или текста) в виде наложения, которое отображается на каждой печатной странице или в определённых разделах, таких как заголовки/нижние колонтитулы.
Какая библиотека поддерживает это в Java? GroupDocs.Watermark Java SDK (последний релиз).
Нужна ли лицензия? Бесплатная пробная версия подходит для разработки; коммерческая лицензия требуется для продакшна.
Можно ли добавить логотип в заголовок? Да — используйте водяной знак‑изображение и задайте параметр заголовка (add logo to header).
Можно ли обработать несколько листов одновременно? Пройдитесь по индексам листов и примените одинаковый водяной знак к каждому листу.

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

GroupDocs.Watermark for Java SDK (версия 24.11 или новее).
Java Development Kit (JDK) 8 или выше.
Базовое знакомство с Java и структурой файлов Excel.

Настройка GroupDocs.Watermark for Java SDK

Сначала добавьте необходимые зависимости Maven, чтобы SDK был доступен в вашем classpath.

Maven Configuration

<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>

Direct Download

Если вы предпочитаете не использовать Maven, скачайте последний JAR с официальной страницы релизов: GroupDocs releases.

Получение лицензии

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

Initialization and Setup

Create a Watermarker instance that will load the Excel file and act as the entry point for all watermark operations.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.options.SpreadsheetLoadOptions;

// Initialize Load Options
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();

// Create Watermarker instance with your spreadsheet file path
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", loadOptions);

Как добавить водяной знак в заголовок/нижний колонтитул таблицы

Ниже представлен пошаговый процесс, демонстрирующий функциональность java add image watermark и также показывающий, как можно add logo to header.

Step 1: Configure Loading Options

We start by defining load options and re‑instantiating the Watermarker. This ensures the SDK reads the workbook correctly.

import com.groupdocs.watermark.common.HorizontalAlignment;
import com.groupdocs.watermark.common.VerticalAlignment;
import com.groupdocs.watermark.options.SpreadsheetLoadOptions;

// Load the document with specified load options
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", loadOptions);

Step 2: Create and Configure Image Watermark

Создайте объект ImageWatermark, указывающий на изображение, которое вы хотите внедрить (например, логотип или значок “CONFIDENTIAL”). Отрегулируйте его выравнивание и масштабирование, чтобы он хорошо вписывался в область заголовка/нижнего колонтитула.

import com.groupdocs.watermark.watermarks.ImageWatermark;
import com.groupdocs.watermark.watermarks.SizingType;

// Initialize the image watermark with your logo or desired image
ImageWatermark watermark = new ImageWatermark("YOUR_DOCUMENT_DIRECTORY/logo.png");

// Set alignment and scaling for a proper fit within the header/footer
watermark.setVerticalAlignment(VerticalAlignment.Top);
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setSizingType(SizingType.ScaleToParentDimensions); // Scales with parent dimensions
watermark.setScaleFactor(1); // Adjust scale factor as needed

Step 3: Configure Header/Footer Options

Укажите SDK, какой лист и какая часть (заголовок или нижний колонтитул) должна получить водяной знак. Здесь вы можете add logo to header или выбрать нижний колонтитул.

import com.groupdocs.watermark.options.SpreadsheetWatermarkHeaderFooterOptions;

// Set options for applying the watermark
SpreadsheetWatermarkHeaderFooterOptions headerFooterOptions = new SpreadsheetWatermarkHeaderFooterOptions();
headerFooterOptions.setWorksheetIndex(0); // Apply to first worksheet (index 0)

Step 4: Add the Watermark

Теперь прикрепите подготовленный водяной знак‑изображение к выбранному месту заголовка/нижнего колонтитула.

// Add the configured watermark
watermarker.add(watermark, headerFooterOptions);

Step 5: Save and Close

Сохраните изменения в новый файл, чтобы оригинальная книга осталась нетронутой, затем освободите ресурсы.

// Save the watermarked document
watermarker.save("YOUR_OUTPUT_DIRECTORY/out_spreadsheet.xlsx");

// Release resources by closing the Watermarker instance
watermarker.close();

Troubleshooting Tips

Тщательно проверьте путь к изображению; неверный путь вызывает FileNotFoundException.
Индексы листов начинаются с 0; убедитесь, что указанный индекс действительно существует.
Если водяной знак выглядит искажённым, отрегулируйте setScaleFactor или переключите SizingType на StretchToParentDimensions.

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

Поддержка разных форматов – работает с Excel, Word, PowerPoint, PDF и изображениями.
Редактирование без потери данных – оригинальные данные ячеек остаются нетронутыми.
Оптимизированная производительность – подходит для больших книг и пакетной обработки.

Практические сценарии использования

Сценарий	Как водяной знак помогает
Confidential reports	Добавьте изображение “CONFIDENTIAL” на каждую печатную страницу.
Brand reinforcement	Разместите логотип вашей компании в заголовке счетов-фактур.
Version tracking	Внедрите значок с номером версии, который обновляется автоматически.
Legal compliance	Отметьте регулируемые таблицы печатью соответствия.

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

Использование памяти – Следите за кучей JVM при обработке очень больших таблиц.
Пакетная обработка – Обрабатывайте файлы группами, чтобы снизить потребление памяти.
Повторное использование объектов – Повторное использование одного экземпляра Watermarker для нескольких файлов уменьшает накладные расходы.

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

В: Можно ли добавить несколько водяных знаков в один документ?
О: Да, создавая дополнительные экземпляры ImageWatermark и настраивая каждый перед вызовом watermarker.add().

В: Как удалить существующий водяной знак из таблицы?
О: В текущей версии GroupDocs.Watermark основной упор делается на добавление водяных знаков. Чтобы удалить его, необходимо воссоздать книгу без водяного знака или использовать инструмент, поддерживающий извлечение водяных знаков.

В: Какие форматы изображений поддерживаются для водяных знаков?
О: Поддерживаются распространённые форматы, такие как PNG и JPEG, но проверьте GroupDocs documentation для полного списка совместимых форматов.

В: Можно ли добавить водяной знак в защищённые паролем таблицы?
О: Да, при условии, что вы предоставите необходимый пароль при открытии файла.

В: Как применить водяные знаки ко всем листам в документе?
О: Пройдитесь по каждому индексу листа и повторите шаги наложения водяного знака, задавая headerFooterOptions.setWorksheetIndex(i) для каждой итерации.

Заключение

Теперь у вас есть полный готовый к продакшну метод для java add excel watermark — конкретно водяного знака‑изображения — с использованием GroupDocs.Watermark Java SDK. Этот подход добавляет брендинг, уведомления о конфиденциальности или любой визуальный индикатор непосредственно в заголовок или нижний колонтитул ваших файлов Excel, оставляя исходные данные нетронутыми. Не стесняйтесь исследовать другие типы водяных знаков (текст, фигура) и комбинировать их для более надёжной защиты документов.

Last Updated: 2026-03-20
Tested With: GroupDocs.Watermark 24.11 for Java
Author: GroupDocs