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

在當今快速變化的數位環境中，add text watermark java 是保護 PDF、Word 檔案、圖片及其他資產免於未授權重用的實用方法。本教學將帶領您完成安裝 GroupDocs.Watermark、進行設定，並在 Java 應用程式中嵌入文字與圖片浮水印。完成後，您將了解如何自訂透明度、位置與樣式，並取得可直接執行的程式碼片段，方便套用到自己的專案中。

快速解答

  • 在 Java 中添加文字浮水印的最簡單方法是什麼？ 建立 TextWatermark 物件，設定其屬性，然後在 Watermarker 實例上呼叫 add()。
  • 哪個 Maven 依賴會加入 GroupDocs.Watermark？ 在 pom.xml 中加入 <groupId>com.groupdocs</groupId> 和 <artifactId>groupdocs-watermark</artifactId> 條目。
  • 我可以控制浮水印的透明度嗎？ 可以，使用 setOpacity(double)，其中 0 表示完全透明，1 表示完全不透明。
  • 生產環境需要授權嗎？ 商業授權是生產使用的必備條件；亦提供免費試用版供評估使用。
  • 支援哪些檔案格式？ 超過 30 種格式，包括 PDF、DOCX、XLSX、PPTX、PNG、JPEG 與 TIFF 等。

TextWatermark 代表可套用於文件的文字型浮水印。
Watermarker 是用於載入文件並套用浮水印的主要類別。
setOpacity(double) 設定浮水印的透明度等級。

什麼是 add text watermark Java？

在 Java 中添加文字浮水印是指在執行時使用 API 將自訂文字覆蓋於文件或圖片上。GroupDocs.Watermark 提供流暢的 Java 介面，讓此作業無需第三方工具即可完成。浮水印可包含自訂字型、顏色、旋轉與位置，使開發者能以程式方式在多種檔案類型上進行品牌化或內容保護。

為何在 Java 中使用 GroupDocs.Watermark？

GroupDocs.Watermark 支援 30+ 種輸入與輸出格式，且可在不將整個文件載入記憶體的情況下處理高達 500 MB 的檔案。其 API 能在標準 VM 上對一般 10 頁 PDF 於 200 ms 內加入浮水印，具備高速與低記憶體佔用的特性，適合高吞吐量服務。

前置條件

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

必要的函式庫、版本與相依性

  • GroupDocs.Watermark Library：版本 24.11 或更新版本
  • Java SE 8 或以上（此函式庫相容於 Java 11、17 及更新版本）

環境設定需求

  • 如 IntelliJ IDEA 或 Eclipse 等 IDE，用於編寫與執行 Java 程式碼。
  • 系統已安裝 Maven，以便輕鬆管理相依性。

知識前置條件

  • 基本的 Java 程式概念了解
  • 熟悉 XML 設定檔，特別是 Maven 專案的設定

完成前置條件後，讓我們為 Java 設定 GroupDocs.Watermark。

為 Java 設定 GroupDocs.Watermark

要將 GroupDocs.Watermark 整合至您的專案，可使用 Maven 或直接下載函式庫。以下說明如何操作：

使用 Maven

將以下設定加入 pom.xml 檔案，以在 Maven 專案中加入 GroupDocs.Watermark：

<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 下載最新版本。

取得授權步驟

  1. Free trial – 先下載試用版以探索函式庫功能。
  2. Temporary license – 若在開發期間需要更廣泛的存取權，可取得暫時授權。
  3. Purchase – 長期使用時，請向 GroupDocs 購買商業授權。

基本初始化與設定

以下說明如何在 Java 應用程式中初始化 GroupDocs.Watermark：

import com.groupdocs.watermark.Watermarker;

public class WatermarkSetup {
    public static void main(String[] args) {
        // Initialize watermarker with the path to your document
        Watermarker watermarker = new Watermarker("your-file-path");

        System.out.println("GroupDocs.Watermark initialized successfully!");
        
        // Remember to close the watermarker when done
        watermarker.close();
    }
}

設定完成後，讓我們繼續實作特定的浮水印功能。

實作指南

添加文字浮水印

概述：
使用 GroupDocs.Watermark 在文件中嵌入文字浮水印是一個簡單的流程。此功能讓您能夠加入自訂文字覆蓋，以有效保護數位資產。

步驟

  1. Create a text watermark – 定義浮水印的內容與樣式。
  2. Add watermark to document – 將浮水印嵌入文件或圖片。
  3. Save changes – 確認所有變更已儲存，以呈現新的浮水印。
import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.contents.WatermarkableImage;
import com.groupdocs.watermark.options.PdfLoadOptions;
import com.groupdocs.watermark.watermarks.TextWatermark;
import java.awt.Color;
import java.awt.Font;

public class AddTextWatermark {
    public static void main(String[] args) {
        // Load a PDF document
        PdfLoadOptions loadOptions = new PdfLoadOptions();
        Watermarker watermarker = new Watermarker("your-file-path.pdf", loadOptions);

        // Create and customize the text watermark
        TextWatermark textWatermark = new TextWatermark("Confidential", new Font("Arial", 36));
        textWatermark.setForegroundColor(Color.getRed());
        textWatermark.setBackgroundColor(Color.getWhite());
        textWatermark.setOpacity(0.5);
        
        // Add the watermark to all pages
        watermarker.add(textWatermark);

        // Save and close
        watermarker.save("output-file-path.pdf");
        watermarker.close();
    }
}

參數與用途

  • TextWatermark 為代表文字覆蓋的類別，可自訂字型、顏色與大小等屬性。
  • setOpacity() 調整浮水印的透明或不透明程度，接受 0（完全透明）至 1（完全不透明）的值。

疑難排解提示

  • 確認文件路徑正確，以避免 file not found 錯誤。
  • 確保所需字型（例如 Arial）已安裝於主機；否則函式庫會回退至預設字型。

添加圖片浮水印

概述：
圖片浮水印可透過將商標或自訂圖片嵌入文件，提供額外的保護層。本節將指導您如何添加基於圖片的浮水印。

步驟

  1. Load your image – 準備作為浮水印的圖片檔案。
  2. Configure watermark properties – 設定位置、透明度等屬性。
  3. Embed watermark – 將圖片浮水印加入文件中。
import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.contents.WatermarkableImage;
import com.groupdocs.watermark.options.PdfLoadOptions;
import com.groupdocs.watermark.watermarks.ImageWatermark;
import java.io.FileInputStream;
import java.io.IOException;

public class AddImageWatermark {
    public static void main(String[] args) throws IOException {
        // Load a PDF document
        PdfLoadOptions loadOptions = new PdfLoadOptions();
        Watermarker watermarker = new Watermarker("your-file-path.pdf", loadOptions);

        // Create and customize the image watermark
        ImageWatermark imageWatermark = new ImageWatermark(new FileInputStream("logo.png"));
        imageWatermark.setOpacity(0.5);
        
        // Add the watermark to all pages
        watermarker.add(imageWatermark);

        // Save and close
        watermarker.save("output-file-path.pdf");
        watermarker.close();
    }
}

參數與用途

  • ImageWatermark 為代表圖片覆蓋的類別，提供縮放、旋轉與定位等選項。
  • setOpacity() 與文字浮水印的使用方式相同，讓您能打造細緻或醒目的品牌效果。

疑難排解提示

  • 確認圖片路徑正確且 Java 程序能存取該檔案。
  • 若圖片未顯示，請檢查其尺寸，並確保透明度值未設為 0。

實務應用

GroupDocs.Watermark 可應用於多種實務情境：

  1. Document protection – 在對外分享前，以公司標誌或機密聲明保護敏感 PDF。
  2. Image copyrighting – 在圖片中嵌入版權資訊，以防止未授權使用。
  3. Educational material – 為數位教材或講義加上浮水印，避免未經許可的散布。
  4. Marketing materials – 透過嵌入品牌元素的浮水印，保護宣傳冊與簡報。

與其他系統（如 CMS 平台或文件管理解決方案）整合，可進一步提升數位資產的安全防護。

常見問題

Q: 我可以使用 GroupDocs.Watermark 在同一文件中加入多個浮水印嗎？
A: 可以，您可在儲存前多次呼叫 add() 方法，加入多個文字或圖片浮水印。

Q: 能否使用 GroupDocs.Watermark 移除文件中已存在的浮水印？
A: GroupDocs.Watermark 主要著重於新增浮水印。若要移除或提取已存在的浮水印，需依文件類型使用更進階的技術或手動編輯。

Q: GroupDocs.Watermark 是否支援所有檔案格式的浮水印？
A: 它支援超過 30 種常見格式，包括 PDF、DOCX、XLSX、PPTX、PNG、JPEG 與 TIFF。請隨時查閱最新文件以確認是否有新增支援的格式。

Q: 我能根據頁面版面或內容自動化浮水印的放置與樣式嗎？
A: 可以，您可依照自訂邏輯（如頁面尺寸或內容區域）以程式方式控制浮水印的位置、大小與樣式。

Q: 有沒有方法在 GroupDocs.Watermark 中套用透明或半透明的浮水印？
A: 當然可以。使用 setOpacity() 方法調整透明度，即可實現半透明的浮水印，以提供細微的保護。

結論

精通 Java 版的 GroupDocs.Watermark，讓您能輕鬆保護與為數位文件與圖片加上品牌標示。透過自訂文字與圖片浮水印，您可提升安全性、防止未授權使用，並在應用程式中無縫強化品牌形象。

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

相關教學