如何在 Java 中使用 GroupDocs.Watermark 添加水印

保护文档的真实性或通过图像水印提升品牌形象至关重要，无论是发票、合同还是营销材料。GroupDocs.Watermark for Java 简化了此任务，同时保持文档质量。

在本教程中，您将学习 如何在 Java 文档中添加水印，具体为添加图像水印。您将了解设置过程和实现细节，以及一些性能注意事项。

快速答案

• “如何添加水印”是什么意思？ 它指在文档中插入可见标记——图像或文字——以表明所有权或品牌。
• 哪个库适合在 Java 中添加图像水印？ GroupDocs.Watermark for Java 提供了直接的 API。
• 需要许可证吗？ 提供免费试用；生产环境需要付费许可证。
• 可以处理 Excel、Word 和 PDF 文件吗？ 可以，库支持包括 XLSX、DOCX、PDF 在内的多种格式。
• 支持批量处理吗？ 完全支持——通过循环文件并复用 Watermarker 对象，可高效地为大量文档添加水印。

在 Java 中“如何添加水印”是什么？

添加水印指以编程方式在文档的每一页上放置图像（或文字）。此视觉提示有助于保护知识产权、确认真实性或强化品牌形象。

为什么使用 GroupDocs.Watermark for Java？

• 易于集成 – 简单的 Maven 坐标或直接下载。
• 广泛的格式支持 – 支持 PDF、Office 文件、图像等多种格式。
• 细粒度控制 – 对齐方式、不透明度、旋转和缩放均可配置。
• 性能优化 – 新版本降低内存占用并提升处理速度。

前置条件

在添加图像水印之前，请确保您具备以下条件：

必需的库和依赖

• GroupDocs.Watermark for Java：建议使用 24.11 或更高版本。

环境搭建要求

• 已在机器上安装 Java Development Kit (JDK)
• 使用 IntelliJ IDEA、Eclipse 等集成开发环境 (IDE)

知识前提

• 基础的 Java 编程了解
• 熟悉 Java 中的文件操作

设置 GroupDocs.Watermark for Java

要使用 GroupDocs.Watermark，请按以下方式将库集成到项目中：

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 的授权页面。

完成上述设置后，我们将演示如何初始化和配置 GroupDocs.Watermark。

在 Java 中为文档添加水印的方法

我们将介绍两个主要功能：java add image watermark 和创建可复用的 ImageWatermark 对象。

向文档添加图像水印

此功能可通过添加自定义图像水印来提升文档的真实性或品牌形象。

步骤 1：从文件流打开文档

首先打开需要添加水印的文档：

import java.io.FileInputStream;
import com.groupdocs.watermark.Watermarker;

final String documentPath = "YOUR_DOCUMENT_DIRECTORY/document.xlsx"; // Replace with actual path.
FileInputStream stream = new FileInputStream(documentPath);

步骤 2：初始化 Watermarker 对象

使用文件流初始化 Watermarker 对象：

Watermarker watermarker = new Watermarker(stream);

步骤 3：创建 ImageWatermark 对象

通过指定图像路径创建水印对象：

import com.groupdocs.watermark.watermarks.ImageWatermark;

final String watermarkImagePath = "YOUR_DOCUMENT_DIRECTORY/logo.png"; // Replace with actual path.
ImageWatermark watermark = new ImageWatermark(watermarkImagePath);

步骤 4：设置水印对齐方式

根据需求设置水印的对齐方式：

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

watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setVerticalAlignment(VerticalAlignment.Center);

步骤 5：添加水印

将配置好的水印应用到文档：

watermarker.add(watermark);

步骤 6：保存文档

将修改后的文档保存到新位置：

final String outputPath = "YOUR_OUTPUT_DIRECTORY/output_document.xlsx"; // Replace with actual path.
watermarker.save(outputPath);

步骤 7：关闭资源

关闭所有流和对象，释放系统资源：

watermark.close();
watermarker.close();
stream.close();

创建 ImageWatermark 对象

单独创建水印对象可在应用前进行配置——当需要在多个文档中复用同一水印时非常有用。

步骤 1：创建 ImageWatermark 对象

使用图像路径进行初始化：

ImageWatermark watermark = new ImageWatermark(watermarkImagePath);

步骤 2：配置对齐方式

设置水印在文档中的对齐方式：

watermark.setHorizontalAlignment(ImageWatermark.HorizontalAlignment.Center);
watermark.setVerticalAlignment(ImageWatermark.VerticalAlignment.Center);

实际应用场景

1. 文档品牌化 – 为公司文档添加徽标水印。
2. 保护知识产权 – 使用水印标示图像或文字的所有权。
3. 文档认证 – 添加可见标记以进行真实性验证。

可将此功能集成到处理文档创建与管理的系统中，例如 ERP 或 CRM 平台。

性能注意事项

• 通过在使用后及时关闭流来优化内存使用。
• 使用最新版本的 GroupDocs.Watermark，以获得性能改进。
• 对应用进行性能分析，识别水印处理瓶颈，尤其是在处理大批量文件时。

常见问题与解决方案

常见问答

问：如何在免费试用和购买 GroupDocs.Watermark 之间做选择？
答：先使用免费试用评估功能；若需完整的生产特性，请购买许可证。

问：我还能添加文字水印吗？
答：可以，库同时支持图像和文字水印。

问：该库支持哪些文件类型的水印？
答：支持 PDF、Word 文档、Excel 表格、PowerPoint 演示文稿以及多种图像格式。

问：如何在大批量处理中使用水印？
答：遍历文件时尽可能复用单个 Watermarker 实例，并监控内存使用情况。

问：水印能否轻松从输出文档中移除？
答：水印是嵌入式的；移除需要重新处理或使用库提供的移除 API。

结论

在 Java 中使用 GroupDocs.Watermark 添加图像水印是提升文档安全性和品牌形象的有效方法。本指南带您完成了环境搭建、配置以及高效的水印应用。接下来，可探索更多水印功能——如文字水印、不透明度控制或批量处理，以进一步扩展文档工作流。

资源

• 文档
• API 参考
• 下载库
• GitHub 仓库
• 免费支持论坛
• 临时许可证信息

最后更新： 2026-01-08
测试环境： GroupDocs.Watermark 24.11 for Java
作者： GroupDocs