SpringBoot应用中PDF添加水印的五种实现方案对比

 更新时间:2025年08月27日 09:54:36   作者:墨瑾轩  
在 Spring Boot 应用中实现 PDF 添加水印,这篇文章为大家整理了五种常见方案及详细实现步骤,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下

在 Spring Boot 应用中实现 PDF 添加水印,以下是五种常见方案及详细实现步骤:

方案一:使用 Apache PDFBox

特点:开源免费,功能强大,支持文本水印添加。

步骤:

添加依赖pom.xml):

<dependency>
    <groupId>org.apache.pdfbox</groupId>
    <artifactId>pdfbox</artifactId>
    <version>2.0.24</version>
</dependency>

实现代码

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDPageContentStream;
import org.apache.pdfbox.pdmodel.font.PDType1Font;

import java.io.File;
import java.io.IOException;

public class PdfBoxWatermark {
    public static void addWatermark(String inputPath, String outputPath, String watermarkText) throws IOException {
        PDDocument document = PDDocument.load(new File(inputPath));
        for (PDPage page : document.getDocumentCatalog().getPages()) {
            PDPageContentStream contentStream = new PDPageContentStream(document, page, PDPageContentStream.AppendMode.APPEND, true, true);
            contentStream.setFont(PDType1Font.HELVETICA_BOLD, 36);
            contentStream.setNonStrokingColor(200, 200, 200); // 设置透明度
            contentStream.beginText();
            contentStream.newLineAtOffset(100, 100); // 水印位置
            contentStream.showText(watermarkText); // 水印内容
            contentStream.endText();
            contentStream.close();
        }
        document.save(outputPath);
        document.close();
    }
}

调用示例

public class Main {
    public static void main(String[] args) throws IOException {
        PdfBoxWatermark.addWatermark("original.pdf", "output.pdf", "CONFIDENTIAL");
    }
}

方案二:使用 iText

特点:功能全面,支持文本和图片水印,适合复杂场景。

步骤:

添加依赖pom.xml):

<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itext7-core</artifactId>
    <version>7.2.6</version>
    <type>pom</type>
</dependency>

实现代码

import com.itextpdf.kernel.pdf.*;
import com.itextpdf.kernel.pdf.canvas.PdfCanvas;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;

public class ITextWatermark {
    public static void addWatermark(String inputPath, String outputPath, String watermarkText) throws IOException {
        PdfReader reader = new PdfReader(new File(inputPath));
        PdfWriter writer = new PdfWriter(outputPath);
        PdfDocument pdfDoc = new PdfDocument(reader, writer);

        for (int i = 1; i <= pdfDoc.getNumberOfPages(); i++) {
            PdfPage page = pdfDoc.getPage(i);
            PdfCanvas canvas = new PdfCanvas(page);
            canvas.beginText();
            canvas.setFontAndSize(PdfFontFactory.createFont(), 60);
            canvas.setTextMatrix(150, 400); // 水印位置
            canvas.showText(watermarkText);
            canvas.endText();
        }
        pdfDoc.close();
    }
}

调用示例

public class Main {
    public static void main(String[] args) throws IOException {
        ITextWatermark.addWatermark("original.pdf", "output.pdf", "DRAFT");
    }
}

方案三:使用 Aspose.PDF for Java

特点:商业库,功能丰富,支持复杂操作(如图片水印、动态水印)。

步骤:

添加依赖pom.xml):

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-pdf</artifactId>
    <version>21.4</version>
</dependency>

实现代码(添加文本水印):

import com.aspose.pdf.*;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;

import java.io.ByteArrayOutputStream;

public class AsposeWatermark {
    public static byte[] addWatermark(MultipartFile file, String watermarkText) throws Exception {
        Document pdfDocument = new Document(file.getInputStream());
        TextStamp textStamp = new TextStamp(watermarkText);
        textStamp.setVerticalAlignment(VerticalAlignment.Center);
        textStamp.setHorizontalAlignment(HorizontalAlignment.Center);
        pdfDocument.getPages().get_Item(1).addStamp(textStamp);

        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
        pdfDocument.save(outputStream);
        return outputStream.toByteArray();
    }
}

REST API 示例

@PostMapping("/addWatermark")
public ResponseEntity<byte[]> addWatermark(@RequestParam("file") MultipartFile file) throws Exception {
    byte[] result = AsposeWatermark.addWatermark(file, "CONFIDENTIAL");
    return ResponseEntity.ok()
            .header("Content-Disposition", "attachment; filename=\"watermarked.pdf\"")
            .contentType(MediaType.APPLICATION_PDF)
            .body(result);
}

方案四:使用第三方 API 服务

特点:无需维护本地库,适合快速集成。

步骤:

选择服务:如 Adobe Document Cloud、DocuSign 等。

注册 API 密钥

调用 API(示例使用 RestTemplate):

public byte[] addWatermarkViaApi(String apiKey, String filePath, String watermarkText) {
    HttpHeaders headers = new HttpHeaders();
    headers.set("Authorization", "Bearer " + apiKey);
    headers.setContentType(MediaType.MULTIPART_FORM_DATA);

    MultiValueMap<String, Object> body = new LinkedMultiValueMap<>();
    body.add("file", new FileSystemResource(filePath));
    body.add("watermarkText", watermarkText);

    HttpEntity<MultiValueMap<String, Object>> request = new HttpEntity<>(body, headers);
    ResponseEntity<byte[]> response = restTemplate.postForEntity("https://api.example.com/addWatermark", request, byte[].class);
    return response.getBody();
}

方案五:基于模板生成 PDF

特点:适合固定格式的 PDF,结合模板引擎(如 Thymeleaf)。

步骤:

准备模板:创建包含水印的 PDF 模板。

填充数据:使用模板引擎动态填充内容。

转换为 PDF(示例使用 iText):

public void generatePdfWithTemplate(String templatePath, String outputPath, Map<String, Object> data) {
    // 使用 Thymeleaf 生成 HTML
    String htmlContent = templateEngine.process("template.html", data);
    // 将 HTML 转换为 PDF(需额外依赖如 Flying Saucer)
    ITextRenderer renderer = new ITextRenderer();
    renderer.setDocumentFromString(htmlContent);
    renderer.layout();
    renderer.createPDF(new FileOutputStream(outputPath));
}

总结对比

方案优点缺点适用场景
Apache PDFBox免费开源,简单易用功能相对基础快速添加文本水印
iText功能全面,支持复杂操作商业版本需付费需要高级功能(如图片水印)
Aspose.PDF功能强大,支持复杂场景商业库,费用较高企业级应用
第三方 API无需维护,快速集成依赖网络,成本可能较高原型开发或轻量级需求
模板生成适合固定格式,灵活度高需要模板设计和转换工具报告、合同等固定格式文档

根据实际需求选择合适的方案,例如:

  • 快速实现:Apache PDFBox 或 iText。
  • 企业级需求:Aspose.PDF。
  • 无需维护:第三方 API。

到此这篇关于SpringBoot应用中PDF添加水印的五种实现方案对比的文章就介绍到这了,更多相关SpringBoot PDF添加水印内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java使用poi包读取Excel文档代码分享

    Java使用poi包读取Excel文档代码分享

    这篇文章主要介绍了Java使用poi包读取Excel文档代码分享,具有一定借鉴价值,需要的朋友可以参考下。
    2017-12-12
  • Java读取文本文件的各种方法

    Java读取文本文件的各种方法

    这篇文章主要介绍了Java读取文本文件的各种方法,在 Java 中有多种方法可以读取纯文本文件,例如你可以使用FileReader、BufferedReader或Scanner来读取文本文件,感兴趣的小伙伴和小编一起进入文章了解更多内容吧,希望能帮助到大家
    2021-11-11
  • IntelliJ IDEA 2024.2 发布新功能介绍Spring Data JPA即时查询、自动补全cron表达式

    IntelliJ IDEA 2024.2 发布新功能介绍Spring Data JPA即时查询、自动补全cro

    在2024.2 Ultimate版本中,对 Spring Data JPA 的支持做了增强,新功能允许您在不运行应用程序和分析日志文件的情况下查看方法将生成的查询,下面就来一起看看这个版本中推出的几个强大新特性
    2024-08-08
  • JAVA内存空间相关知识汇总

    JAVA内存空间相关知识汇总

    这篇文章主要介绍了JAVA内存空间相关知识,文中介绍的非常详细,代码帮助大家更好的参考和学习,感兴趣的朋友可以了解下
    2020-06-06
  • java枚举的使用示例

    java枚举的使用示例

    我们在学习编程语言的时候都学过枚举,现在就具体来看看java中的枚举的使用
    2013-12-12
  • 详解Java编程中对象的序列化

    详解Java编程中对象的序列化

    这篇文章主要介绍了Java编程中对象的序列化,包括一些反序列化的例子,需要的朋友可以参考下
    2015-11-11
  • 一步步教你搭建Scala开发环境(非常详细!)

    一步步教你搭建Scala开发环境(非常详细!)

    Scala是一门基于jvm的函数式的面向对象编程语言,拥有比java更加简洁的语法,下面这篇文章主要给大家介绍了关于搭建Scala开发环境的相关资料,文中通过图文介绍的非常详细,需要的朋友可以参考下
    2022-04-04
  • Nacos作为配置中心注册监听器方法

    Nacos作为配置中心注册监听器方法

    本文主要讨论Nacos作为配置中心时,其中配置内容发生更改时,我们的应用程序能够做的事。一般使用监听器来实现这步操作,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习吧
    2023-02-02
  • Java SpringMVC实现自定义拦截器

    Java SpringMVC实现自定义拦截器

    这篇文章主要为大家详细介绍了SpringMVC实现自定义拦截器,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2022-03-03
  • Jenkins系统如何进行数据备份

    Jenkins系统如何进行数据备份

    随着我们的长期使用,Jenkins系统中的内容会越来越多,特别是一些配置相关的东西,不能有任何丢失。这个时候我们就需要定期备份我们的Jenkins系统,避免一些误操作不小心删除了某些重要文件,本文就将介绍下Jenkins系统如何进行数据备份
    2021-06-06

最新评论