使用 Java 对 PDF 添加水印：提升文档安全与版权保护

在当今数字化办公环境中，PDF 文档作为信息交流和存储的重要载体，其安全性和版权保护变得尤为关键。企业常常需要对内部敏感文档或对外发布的资料添加水印，以防止未经授权的使用、泄露或篡改。那么，如何通过 Java 编程高效、灵活地实现 PDF 水印的添加呢？

本文将为您揭示这一问题的解决方案。我们将深入探讨如何利用功能强大且易于集成的 Spire.PDF for Java 库，为您的 PDF 文档添加专业的文本水印 和图片水印。通过本文提供的详细教程和可运行的代码示例，您将能够轻松掌握 PDF 水印技术，有效提升文档的安全性和专业性。

---

认识 Spire.PDF for Java 及其在水印处理中的优势

Spire.PDF for Java 是一款专为 Java 应用程序设计的专业 PDF 文档处理库。它提供了丰富的功能，包括 PDF 的创建、编辑、转换、合并、分割、加密解密以及各种高级操作，如表单填充、电子签名和我们今天要重点讨论的水印添加。

该库具有以下显著优势：

• 跨平台兼容性：支持 Windows、Linux、macOS 等多种操作系统，确保您的应用在不同环境下稳定运行。
• 功能丰富：不仅限于水印，还涵盖了 PDF 处理的方方面面，满足企业级应用需求。
• 易于集成：提供清晰的 API 接口和详细的文档，开发者可以快速上手并将其集成到现有项目中。
• 高性能：优化了处理效率，能够快速处理大量 PDF 文档。
• 灵活的水印配置：允许开发者精细控制水印的文本内容、字体、颜色、大小、透明度、旋转角度、位置等，以及图片水印的尺寸、位置和透明度。

如何获取和配置 Spire.PDF for Java 依赖

要开始使用 Spire.PDF for Java，您需要将其作为依赖添加到您的 Maven 项目中。

Maven 依赖示例：

<repositories>
    <repository>
        <id>e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.pdf</artifactId>
        <version>5.12.7</version> <!-- 请替换为最新版本 -->
    </dependency>
</dependencies>

---

如何使用 Java 添加文本水印到 PDF

添加文本水印是保护文档版权和防止滥用的常见方法。Spire.PDF for Java 提供了强大的功能来定制文本水印的外观。

以下是添加文本水印的详细步骤和代码示例：

1. 加载 PDF 文档：使用 PdfDocument 类加载现有 PDF 文件。
2. 创建水印内容：定义水印文本、字体、大小、颜色、旋转角度和透明度等属性。
3. 遍历页面并应用水印：遍历 PDF 文档的每一个页面，并在页面上绘制水印。为了实现页面的平铺效果，通常会创建一个 PdfTilingBrush。
4. 保存文档：将修改后的 PDF 文档保存到新文件或覆盖原文件。

关键文本水印属性及 API 方法

属性	描述	对应 API 方法/类
内容	水印显示的文字	PdfTilingBrush.getGraphics().drawString()
字体	水印文本的字体	PdfFont
大小	水印文本的字号	PdfFont
颜色	水印文本的颜色	PdfBrushes.getColor()
透明度	水印的透明度（0-1，1为完全不透明）	PdfTilingBrush.getGraphics().setTransparency()
旋转角度	水印文本的旋转角度	PdfTilingBrush.getGraphics().rotateTransform()
位置	水印在页面上的起始位置	PdfTilingBrush.getGraphics().translateTransform()

Java 代码示例：添加文本水印

import com.spire.pdf.*;
import com.spire.pdf.graphics.*;

import java.awt.*;
import java.awt.geom.Dimension2D;
import java.awt.geom.Point2D;
import java.awt.geom.Rectangle2D;
import java.io.IOException;

public class AddTextWatermark {
    public static void main(String[] args) throws IOException {
        // 1. 加载PDF文档
        PdfDocument doc = new PdfDocument();
        doc.loadFromFile("input.pdf"); // 确保input.pdf存在

        // 水印文本
        String watermarkText = "公司机密 严禁转载";

        // 遍历PDF文档的每个页面
        for (int i = 0; i < doc.getPages().getCount(); i++) {
            PdfPageBase page = doc.getPages().get(i);

            // 创建一个尺寸与页面相同的模板，用于绘制水印
            PdfTemplate template = new PdfTemplate(page.getClientSize().getWidth(), page.getClientSize().getHeight());

            // 绘制水印到模板
            drawTextWatermarkToTemplate(template, watermarkText);

            // 创建一个矩形，覆盖整个页面，用于放置水印
            Rectangle2D loRect = new Rectangle2D.Float();
            loRect.setFrame(new Point2D.Float(0, 0), page.getClientSize());

            // 创建水印注释
            PdfWatermarkAnnotation watermarkAnnotation = new PdfWatermarkAnnotation(loRect);
            PdfAppearance appearance = new PdfAppearance(watermarkAnnotation);
            appearance.setNormal(template); // 将绘制了水印的模板设为水印注释的正常外观
            watermarkAnnotation.setAppearance(appearance);
            
            // 将水印注释添加到当前页面的注释集合中
            page.getAnnotationsWidget().add(watermarkAnnotation);
        }

        // 4. 保存带有水印的PDF文档
        doc.saveToFile("output_text_watermark.pdf");
        doc.close();
        System.out.println("文本水印添加成功！文件已保存为 output_text_watermark.pdf");
    }

    private static void drawTextWatermarkToTemplate(PdfTemplate template, String watermark) {
        // 创建一个刷子，用于平铺水印
        // 水印的尺寸设为模板宽度的一半，高度的三分之一，以实现重复平铺效果
        Dimension2D dimension2D = new Dimension();
        dimension2D.setSize(template.getWidth() / 2, template.getHeight() / 3);
        PdfTilingBrush brush = new PdfTilingBrush(dimension2D);

        // 设置水印的透明度为 0.3 (30%)
        brush.getGraphics().setTransparency(0.3f);

        // 保存当前图形状态
        brush.getGraphics().save();

        // 旋转水印，通常为负45度
        brush.getGraphics().rotateTransform(-45);

        // 设置字体和颜色
        PdfFont font = new PdfFont(PdfFontFamily.Helvetica, 24f, PdfFontStyle.Bold);
        PdfStringFormat format = new PdfStringFormat();
        format.setAlignment(PdfStringAlignment.Center);
        format.setLineAlignment(PdfVerticalAlignment.Middle);

        // 在刷子上绘制水印文本
        // 调整绘制位置，使其在刷子区域内居中
        brush.getGraphics().drawString(watermark, font, PdfBrushes.getGray(),
                (float) brush.getSize().getWidth() / 2, (float) brush.getSize().getHeight() / 2, format);

        // 恢复图形状态
        brush.getGraphics().restore();

        // 将绘制了水印的刷子应用到模板上
        template.getGraphics().drawRectangle(brush, new Rectangle2D.Float(0, 0, template.getWidth(), template.getHeight()));
    }
}

---

如何使用 Java 添加图片水印到 PDF

除了文本水印，图片水印（如公司 Logo、保密图章等）也是一种常见的文档保护手段。Spire.PDF for Java 同样支持添加图片水印，并提供灵活的配置选项。

以下是添加图片水印的详细步骤和代码示例：

1. 加载 PDF 文档：使用 PdfDocument 加载现有 PDF 文件。
2. 加载图片文件：使用 PdfImage.fromFile() 方法加载图片文件作为水印。
3. 设置图片水印属性：定义图片水印的位置、大小、透明度和旋转角度。
4. 遍历页面并应用水印：遍历 PDF 文档的每个页面，并在指定位置绘制图片。
5. 保存文档：将修改后的 PDF 文档保存。

关键图片水印属性及 API 方法

属性	描述	对应 API 方法/类
来源	水印图片文件的路径	PdfImage.fromFile()
位置	水印在页面上的 X, Y 坐标	page.getCanvas().drawImage()
大小	水印图片的宽度和高度	page.getCanvas().drawImage()
透明度	水印的透明度（0-1，1为完全不透明）	PdfGraphics.setTransparency()
旋转角度	水印图片的旋转角度	PdfGraphics.rotateTransform()

Java 代码示例：添加图片水印

import com.spire.pdf.*;
import com.spire.pdf.graphics.*;

import java.awt.geom.Point2D;
import java.awt.geom.Rectangle2D;
import java.io.IOException;

public class AddImageWatermark {
    public static void main(String[] args) throws IOException {
        // 1. 加载PDF文档
        PdfDocument doc = new PdfDocument();
        doc.loadFromFile("input.pdf"); // 确保input.pdf存在

        // 2. 加载图片文件作为水印
        PdfImage image = PdfImage.fromFile("watermark.png"); // 确保watermark.png存在

        // 遍历PDF文档的每个页面
        for (int i = 0; i < doc.getPages().getCount(); i++) {
            PdfPageBase page = doc.getPages().get(i);

            // 创建一个尺寸与页面相同的模板
            PdfTemplate template = new PdfTemplate(page.getClientSize().getWidth(), page.getClientSize().getHeight());

            // 设置模板的图形透明度
            template.getGraphics().setTransparency(0.2f); // 20% 透明度

            // 计算图片水印的位置和大小
            float imgWidth = image.getWidth() * 0.5f; // 图片宽度缩放为原始的50%
            float imgHeight = image.getHeight() * 0.5f; // 图片高度缩放为原始的50%
            
            // 将水印放置在页面中心
            float x = (page.getClientSize().getWidth() - imgWidth) / 2;
            float y = (page.getClientSize().getHeight() - imgHeight) / 2;

            // 绘制图片水印到模板
            template.getGraphics().drawImage(image, x, y, imgWidth, imgHeight);

            // 创建一个矩形，覆盖整个页面，用于放置水印
            Rectangle2D loRect = new Rectangle2D.Float();
            loRect.setFrame(new Point2D.Float(0, 0), page.getClientSize());

            // 创建水印注释
            PdfWatermarkAnnotation watermarkAnnotation = new PdfWatermarkAnnotation(loRect);
            PdfAppearance appearance = new PdfAppearance(watermarkAnnotation);
            appearance.setNormal(template); // 将绘制了水印的模板设为水印注释的正常外观
            watermarkAnnotation.setAppearance(appearance);

            // 将水印注释添加到当前页面的注释集合中
            page.getAnnotationsWidget().add(watermarkAnnotation);
        }

        // 4. 保存带有水印的PDF文档
        doc.saveToFile("output_image_watermark.pdf");
        doc.close();
        System.out.println("图片水印添加成功！文件已保存为 output_image_watermark.pdf");
    }
}

---

总结

通过本文的详细教程，您已经掌握了如何使用 Spire.PDF for Java 库为 PDF 文档添加文本水印 和图片水印的关键技术。我们深入探讨了 Spire.PDF for Java 的优势、依赖配置，并提供了清晰、可操作的代码示例，涵盖了水印内容设置、样式调整、透明度控制以及页面应用等核心环节。

Spire.PDF for Java 凭借其强大的功能和灵活的 API 设计，使得在 Java 应用程序中实现专业的 PDF 水印功能变得异常简单和高效。无论是为了保护企业机密、确保版权所有，还是提升文档的专业形象，掌握这一技术都将为您的项目带来显著价值。

现在，您可以将这些知识和代码应用于您的实际项目中，提升文档的安全性和管理水平。希望本文能为您在 Java PDF 处理领域提供有益的参考和帮助！