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

保護文件真偽或透過圖片水印提升品牌形象至關重要，無論是發票、合約或行銷素材皆是如此。GroupDocs.Watermark for Java 讓此工作變得簡單，同時維持文件品質。

在本教學中，您將學會 如何在 Java 文件中加入水印（以圖片水印為例）。內容涵蓋設定流程、實作細節，以及一些效能考量。

快速答疑

  • 「how to add watermark」是什麼意思？ 指在文件中插入可見的標記（圖片或文字），以表明所有權或品牌。
  • 哪個程式庫適合在 Java 中加入圖片水印？ GroupDocs.Watermark for Java 提供直接的 API。
  • 需要授權嗎？ 提供免費試用版；正式上線需購買授權。
  • 能處理 Excel、Word 與 PDF 檔案嗎？ 能，支援包括 XLSX、DOCX、PDF 在內的多種格式。
  • 支援批次處理嗎？ 當然可以——透過迴圈處理檔案並重複使用 Watermarker 物件，即可高效地為大量文件加水印。

「how to add watermark」在 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 版本，以取得效能改進。
  • 針對大型批次處理進行效能分析，找出水印加入的瓶頸。

常見問題與解決方案

問題解決方案
OutOfMemoryError 於大型檔案一次處理單一檔案，處理完畢後即關閉 Watermarker。
水印不顯示確認圖片透明度足夠，且對齊設定正確。
不支援的檔案格式查閱程式庫支援的格式清單；必要時升級至最新版。

FAQ

Q: 如何在免費試用與正式購買 GroupDocs.Watermark 之間做選擇？
A: 先使用免費試用版評估功能；若需正式上線，請購買授權以取得完整功能。

Q: 我也可以加入文字水印嗎？
A: 可以，程式庫同時支援圖片與文字水印。

Q: 這個程式庫能為哪些檔案類型加水印？
A: 支援 PDF、Word、Excel、PowerPoint 以及多種圖片格式。

Q: 大量批次處理時該如何操作？
A: 迭代檔案，盡可能重複使用同一 Watermarker 實例，並持續監控記憶體使用情況。

Q: 能否輕鬆從輸出文件中移除水印？
A: 水印是嵌入式的；若要移除需重新處理或使用程式庫提供的移除 API。

結論

在 Java 中使用 GroupDocs.Watermark 加入圖片水印，是提升文件安全與品牌形象的有效方法。本指南帶您完成環境設定、配置與高效的水印應用。接下來，您可以探索文字水印、透明度控制或批次處理等進階功能，進一步擴充文件工作流程。

參考資源

最後更新： 2026-01-08
測試環境： GroupDocs.Watermark 24.11 for Java
作者： GroupDocs