如何使用 GroupDocs for Java (文字與圖片) 為 PDF 文件加上浮水印

在本教學中，您將學習 如何為 PDF 加上浮水印 檔案，使用 GroupDocs.Watermark for Java 同時加入文字與圖片的浮水印。無論您是構建文件管理系統，或僅需保護單一 PDF，我們都會一步步帶領您，從設定函式庫到自訂浮水印外觀，讓您能快速且安全地以 Java 方式為 PDF 加上浮水印。

快速回答

什麼函式庫可在 Java 中為 PDF 加上浮水印？ GroupDocs.Watermark for Java.
我可以同時加入文字與圖片浮水印嗎？ 是 – API 支援 TextWatermark 和 ImageWatermark.
生產環境需要授權嗎？ 試用版可用於評估；商業部署需正式授權.
需要哪個版本的 Java？ JDK 8 或更高版本.
是否建議使用 Maven 來加入相依性？ 當然 – 它能簡化版本管理.

什麼是 PDF 浮水印？

PDF 浮水印是將可見（或不可見）的標記——例如文字字串或標誌——直接嵌入 PDF 檔案每一頁的過程。這可協助您 為 PDF 加上文字浮水印 或 為 PDF 加上圖片浮水印，以宣示所有權、標示草稿狀態，或遵循品牌指引。

為什麼使用 GroupDocs.Watermark for Java？

功能豐富 – 支援文字、圖片，甚至自訂形狀的浮水印。
跨格式支援 – 可處理 PDF、Word、Excel、PowerPoint 等多種檔案。
細緻控制 – 可調整不透明度、旋轉角度、對齊方式與頁面範圍。
效能最佳化 – 為大規模文件處理而設計。

前置條件

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

已安裝 Java Development Kit (JDK) 8+。
如 IntelliJ IDEA、Eclipse 或 NetBeans 等 IDE。
Maven（或手動加入 JAR 的能力）。
基本的 Java 知識，若熟悉 Maven 更佳。

必要的函式庫與相依性

GroupDocs.Watermark for Java – 提供浮水印功能的核心函式庫。

直接下載（供參考）

您也可以從官方發行頁面手動取得函式庫：GroupDocs.Watermark for Java releases.

設定 GroupDocs.Watermark for Java

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

基本初始化

函式庫可用後，匯入必要的類別並指向您的 PDF 檔案：

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

// Specify your document directory
String inputPath = "YOUR_DOCUMENT_DIRECTORY/document.pdf";
PdfLoadOptions loadOptions = new PdfLoadOptions();
Watermarker watermarker = new Watermarker(inputPath, loadOptions);

新增文字浮水印（add text watermark pdf）

步驟 1：載入 PDF 文件

PdfLoadOptions loadOptions = new PdfLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/document.pdf", loadOptions);

步驟 2：建立並設定文字浮水印

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

TextWatermark textWatermark = new TextWatermark("This is an artifact watermark", new Font("Arial", 8));
textWatermark.setHorizontalAlignment(HorizontalAlignment.Right);

步驟 3：將文字浮水印加入 PDF 文件

watermarker.add(textWatermark, null); // Use default options for simplicity

步驟 4：儲存並關閉已加浮水印的 PDF

watermarker.save("YOUR_OUTPUT_DIRECTORY/out_document.pdf");
watermarker.close();

新增圖片浮水印（add image watermark pdf）

步驟 1：載入 PDF 文件

PdfLoadOptions loadOptions = new PdfLoadOptions();
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/document.pdf", loadOptions);

步驟 2：建立並設定圖片浮水印

import com.groupdocs.watermark.watermarks.ImageWatermark;

ImageWatermark imageWatermark = new ImageWatermark("YOUR_DOCUMENT_DIRECTORY/logo.bmp");

步驟 3：將圖片浮水印加入 PDF 文件

watermarker.add(imageWatermark, null);

步驟 4：關閉並儲存已加浮水印的 PDF

imageWatermark.close();
watermarker.save("YOUR_OUTPUT_DIRECTORY/out_document.pdf");
watermarker.close();

實務應用

將 GroupDocs.Watermark 整合至您的 Java 專案，可在多種情境下保護文件：

法律合約 – 使用「Confidential」文字浮水印標示機密協議。
教育資源 – 嵌入機構標誌，防止未授權分享。
行銷素材 – 以公司標誌為 PDF 加上品牌標記，確保視覺識別一致。
內部報告 – 使用半透明浮水印標示草稿。
訂閱服務 – 保護提供給付費用戶的高級 PDF。

效** ||

| 大型 PDF 發生 OutOfMemoryError | 使用 PdfLoadOptions 並設定 setMemorySavingMode(true)，逐頁處理。 | | 浮水印未顯示 | 確認不透明度與顏色對比；確保浮水印加入了正確的頁面範圍。 | | LicenseException | 在建立 Watermarker 前，透過 License license = new License(); license.setLicense("path/to/license.file"); 套用有效的授權檔案。 |

常見問答

問：如何自訂文字浮水印的外觀？
A: 調整 TextWatermark 物件的屬性，例如字型、大小、顏色、旋轉角度與不透明度。

問：成除 PDF 之外的格式？
A: 當然支援。它亦可處理 Word、Excel、PowerPoint 以及多種影像格式。

問：在浮水印過程中應如何處理例外情況？
A: 將程式碼包在 try { … } catch (Exception e) { e.printStackTrace(); } 中，以捕捉並記錄任何執行時問題。

結論

您現在已擁有一為 PDF 加上浮水印** 指南，使用 GroupDocs.Watermark for Java。依照上述步驟，您可以同時加入文字與圖片浮水印，微調，請參考官方文件：GroupDocs documentation。