SpringBoot應(yīng)用中PDF添加水印的五種實(shí)現(xiàn)方案對(duì)比

更新時(shí)間：2025年08月27日 09:54:36 作者：墨瑾軒

在 Spring Boot 應(yīng)用中實(shí)現(xiàn) PDF 添加水印,這篇文章為大家整理了五種常見方案及詳細(xì)實(shí)現(xiàn)步驟,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下

方案一：使用 Apache PDFBox

特點(diǎn)：開源免費(fèi)，功能強(qiáng)大，支持文本水印添加。

步驟：

添加依賴（pom.xml）：

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

實(shí)現(xiàn)代碼：

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); // 設(shè)置透明度
            contentStream.beginText();
            contentStream.newLineAtOffset(100, 100); // 水印位置
            contentStream.showText(watermarkText); // 水印內(nèi)容
            contentStream.endText();
            contentStream.close();
        }
        document.save(outputPath);
        document.close();
    }
}

調(diào)用示例：

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

方案二：使用 iText

特點(diǎn)：功能全面，支持文本和圖片水印，適合復(fù)雜場景。

步驟：

添加依賴（pom.xml）：

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

實(shí)現(xiàn)代碼：

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();
    }
}

調(diào)用示例：

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

方案三：使用 Aspose.PDF for Java

特點(diǎn)：商業(yè)庫，功能豐富，支持復(fù)雜操作（如圖片水印、動(dòng)態(tài)水?。?。

步驟：

添加依賴（pom.xml）：

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

實(shí)現(xiàn)代碼（添加文本水?。?/p>

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 服務(wù)

特點(diǎn)：無需維護(hù)本地庫，適合快速集成。

步驟：

選擇服務(wù)：如 Adobe Document Cloud、DocuSign 等。

注冊 API 密鑰。

調(diào)用 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

特點(diǎn)：適合固定格式的 PDF，結(jié)合模板引擎（如 Thymeleaf）。

步驟：

準(zhǔn)備模板：創(chuàng)建包含水印的 PDF 模板。

填充數(shù)據(jù)：使用模板引擎動(dòng)態(tài)填充內(nèi)容。

轉(zhuǎn)換為 PDF（示例使用 iText）：

public void generatePdfWithTemplate(String templatePath, String outputPath, Map<String, Object> data) {
    // 使用 Thymeleaf 生成 HTML
    String htmlContent = templateEngine.process("template.html", data);
    // 將 HTML 轉(zhuǎn)換為 PDF（需額外依賴如 Flying Saucer）
    ITextRenderer renderer = new ITextRenderer();
    renderer.setDocumentFromString(htmlContent);
    renderer.layout();
    renderer.createPDF(new FileOutputStream(outputPath));
}

總結(jié)對(duì)比

方案	優(yōu)點(diǎn)	缺點(diǎn)	適用場景
Apache PDFBox	免費(fèi)開源，簡單易用	功能相對(duì)基礎(chǔ)	快速添加文本水印
iText	功能全面，支持復(fù)雜操作	商業(yè)版本需付費(fèi)	需要高級(jí)功能（如圖片水?。?/td>
Aspose.PDF	功能強(qiáng)大，支持復(fù)雜場景	商業(yè)庫，費(fèi)用較高	企業(yè)級(jí)應(yīng)用
第三方 API	無需維護(hù)，快速集成	依賴網(wǎng)絡(luò)，成本可能較高	原型開發(fā)或輕量級(jí)需求
模板生成	適合固定格式，靈活度高	需要模板設(shè)計(jì)和轉(zhuǎn)換工具	報(bào)告、合同等固定格式文檔

根據(jù)實(shí)際需求選擇合適的方案，例如：

快速實(shí)現(xiàn)：Apache PDFBox 或 iText。
企業(yè)級(jí)需求：Aspose.PDF。
無需維護(hù)：第三方 API。

到此這篇關(guān)于SpringBoot應(yīng)用中PDF添加水印的五種實(shí)現(xiàn)方案對(duì)比的文章就介紹到這了,更多相關(guān)SpringBoot PDF添加水印內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: