如何使用 GroupDocs.Watermark for Java 為 Excel 附件添加水印

介紹

如果您需要 為 Excel 添加水印 的工作簿——尤其是那些內嵌 PDF、圖片或其他輔助檔案的工作簿——本指南正適合您。想像一下，您剛完成一份完整的 Excel 商業報告，並附帶多個提供額外資料洞見的附件。透過為每個附件加入文字水印，您即可同時保護品牌形象並傳達機密性。本文將一步步說明如何使用 GroupDocs.Watermark for Java 為 Excel 附件添加水印。

快速回答

需要什麼函式庫？ GroupDocs.Watermark for Java（Maven 或直接下載）。
本教學主要涵蓋哪項任務？ 為 Excel 工作簿內的所有附件加入文字水印。
需要授權嗎？ 試用版可用於評估；正式環境需購買完整授權。
可以一次處理多個附件嗎？ 可以——程式碼會自動遍歷每個附件。
Java 8 足夠嗎？ 足夠，支援 Java 8 及以上版本。

您將學習

如何在 Java 專案中設定 GroupDocs.Watermark。
逐步程式碼示範 java add text watermark 至每個內嵌檔案。
真實案例，例如在內部報告中 add confidential watermark excel。

在開始編寫程式碼之前，先了解先決條件。

先決條件

在開始之前，請確保您具備以下條件：

所需函式庫與相依性

您需要 GroupDocs.Watermark for Java。請使用 Maven 或直接下載的方式將其整合至專案。

環境設定需求

相容的 JDK 版本（Java 8 或以上）。
如 IntelliJ IDEA 或 Eclipse 等 IDE。

知識先備條件

需要具備 Java 程式開發的基礎。了解檔案處理與 Maven XML 設定也會很有幫助。

設定 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.Watermark 時：

先下載函式庫取得免費試用。
取得臨時授權以完整使用功能。
購買正式授權以供長期使用。

基本初始化與設定

建立 Watermarker 實例以初始化專案：

import com.groupdocs.watermark.Watermarker;

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(inputFilePath, new SpreadsheetLoadOptions());

實作指南

現在環境已就緒，讓我們一步步走過 java process excel attachments 的流程。

為 Excel 附件加入文字水印

此功能讓您 一次性為試算表附件套用水印。

1. 建立 TextWatermark 物件

先使用 TextWatermark 定義您的水印：

import com.groupdocs.watermark.watermarks.TextWatermark;
import com.groupdocs.watermark.common.Font;

TextWatermark watermark = new TextWatermark("Test watermark", new Font("Arial", 19));

2. 載入試算表文件

使用 SpreadsheetLoadOptions 開啟試算表：

import com.groupdocs.watermark.options.SpreadsheetLoadOptions;

String inputFilePath = "YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(inputFilePath, new SpreadsheetLoadOptions());

3. 取得並處理附件

遍歷文件的附件以套用水印：

import com.groupdocs.watermark.contents.SpreadsheetContent;
import com.groupdocs.watermark.common.FileType;
import com.groupdocs.watermark.common.IDocumentInfo;
import com.groupdocs.watermark.contents.SpreadsheetAttachment;

var content = watermarker.getContent(SpreadsheetContent.class);
for (SpreadsheetAttachment attachment : content.getWorksheets().stream()
    .flatMap(worksheet -> worksheet.getAttachments().stream())
    .toList()) {
    
    IDocumentInfo info = attachment.getDocumentInfo();
    if (info.getFileType() != FileType.Unknown && !info.isEncrypted()) {
        Watermarker attachedWatermarker = attachment.createWatermarker();

        // Add the watermark to the attachment
        attachedWatermarker.add(watermark);

        // Save changes in the attached file
        attachment.updateContent(attachedWatermarker);
        
        attachedWatermarker.close();
    }
}

4. 儲存已加水印的文件

所有附件處理完畢後，將文件儲存：

String outputFilePath = "YOUR_OUTPUT_DIRECTORY/spreadsheet_with_watermarks.xlsx";
watermarker.save(outputFilePath);

watermarker.close();

疑難排解技巧

確認檔案路徑正確且檔案確實存在。
確保 GroupDocs.Watermark 函式庫版本與 pom.xml 中宣告的版本相符。
若附件被加密，程式碼會跳過——必要時請先解密。

實務應用

以下是 add watermark to excel 在實際情境中的重要應用：

企業品牌 – 在每個附件上插入公司標誌或名稱。
機密標記 – 為報告加上「機密」標籤，以防止未授權的分享。
文件驗證 – 嵌入唯一識別碼，證明文件來源。

您亦可將此方式與文件管理系統（DMS）結合，批次自動處理數百份試算表。

效能考量

最佳化效能

使用串流 API，避免一次將大型附件全部載入記憶體。
大量處理時，可考慮使用 Java 的平行串流，同時處理多個工作表。

資源使用指引

監控堆積記憶體使用量，特別是處理含大量高解析度圖片的巨型 Excel 檔時。

記憶體管理最佳實踐

如程式碼所示，務必關閉 Watermarker 實例。
建議使用 try‑with‑resources 或 finally 區塊以確保資源釋放。

結論

您現在已掌握如何使用 GroupDocs.Watermark for Java 為 Excel 附件 add watermark to excel。此技巧能提升品牌形象、增添機密層級，且能順利整合至現有的 Java 工作流程。

後續步驟

探索圖片水印或對其他檔案類型進行蓋章。
以排程工作自動化處理進來的報告。

今天就試試看，體驗它如何簡化您的文件安全流程！

常見問題

Q1: 能否為非文字附件套用水印？
可以，您可以使用相同的流程為 Excel 附件中的圖片與 PDF 加上文字水印。

Q2: 如何確保水印在文件的每一頁都可見？
在 TextWatermark 建構子中調整字型大小、顏色與不透明度，以符合不同頁面的版面配置。

Q3: GroupDocs.Watermark 支援哪些檔案格式？
支援 Word、PDF、Excel、PowerPoint，以及常見的圖片格式如 PNG 與 JPG。

Q4: 處理附件的數量有沒有上限？
沒有硬性上限，但隨著附件數量增加處理時間會延長——大量批次建議使用平行處理。

Q5: 加入的水印可以移除或編輯嗎？
水印會嵌入檔案，若要變更必須重新以新水印處理文件。

資源

文件說明：GroupDocs.Watermark Java Documentation
API 參考：API Reference for GroupDocs.Watermark
下載函式庫：GroupDocs.Watermark Releases
GitHub 倉庫：GroupDocs Watermark GitHub
免費支援論壇：GroupDocs Forum

最後更新： 2026-03-25
測試版本： GroupDocs.Watermark 24.11 for Java
作者： GroupDocs