SpringBoot应用中PDF添加水印的五种实现方案对比
作者：墨瑾轩
在 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添加水印内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！