在Java中为Word文档添加水印的全面指南
在文档管理中，水印常用于标识文档状态、版权信息或企业标识，通过Java程序为Word文档添加水印，可以自动化处理大量文档，提高工作效率，本文将详细介绍如何使用Java为Word文档添加文本水印、图片水印，并探讨不同场景下的实现方案。
准备开发环境
在开始之前，需确保开发环境已配置必要的库，推荐使用Apache POI，它是处理Office文档的常用开源工具，对于Word文档（.docx格式），需引入POI的OOXML依赖，若需处理旧版.doc格式，需额外引入HWPF模块。
Maven依赖配置如下：
<dependencies>
<!-- POI核心依赖 -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>5.2.3</version>
</dependency>
<!-- POI OOXML支持（用于.docx） -->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>5.2.3</version>
</dependency>
</dependencies>
添加文本水印
文本水印是最常见的水印类型，通常以半透明文字形式显示在文档背景中，实现步骤如下：
-
加载Word文档
使用XWPFDocument类加载.docx文件：XWPFDocument document = new XWPFDocument(new FileInputStream("input.docx")); -
创建水印对象
POI中无直接的水印API，需通过XWPFHeaderFooter实现，首先获取文档的页眉：XWPFHeader header = document.getHeaderFooterPolicy().getDefaultHeader(); if (header == null) { header = document.createHeader(HeaderFooterType.DEFAULT); } -
添加文本段落
在页眉中创建段落并设置水印文字：
XWPFParagraph paragraph = header.createParagraph(); paragraph.setAlignment(ParagraphAlignment.CENTER); XWPFRun run = paragraph.createRun(); run.setText("机密文档"); run.setFontSize(36); run.setColor("C0C0C0"); // 灰色 run.setFontFamily("宋体"); run.setBold(true); -
设置透明度
通过CTTextCharacterProperties调整透明度：CTP ctP = paragraph.getCTP(); CTTextCharacterProperties runProps = ctP.getPArray(0).getRArray(0).getRPr(); if (runProps == null) runProps = ctP.getPArray(0).getRArray(0).addNewRPr(); runProps.setAlpha(30000); // 0-100000，30000约30%透明度
-
保存文档
try (FileOutputStream out = new FileOutputStream("output.docx")) { document.write(out); }
添加图片水印
图片水印常用于企业Logo或防伪标识，实现步骤与文本水印类似，但需使用XWPFPicture：
-
加载图片并插入页眉
XWPFHeader header = document.getHeaderFooterPolicy().getDefaultHeader(); if (header == null) header = document.createHeader(HeaderFooterType.DEFAULT); XWPFParagraph paragraph = header.createParagraph(); paragraph.setAlignment(ParagraphAlignment.CENTER); XWPFRun run = paragraph.createRun(); run.addPicture(new FileInputStream("watermark.png"), DocumentPictureType.PNG, "watermark.png", Units.toEMU(200), // 宽度（EMU单位） Units.toEMU(200)); // 高度 -
调整图片位置和透明度
CTInline inline = paragraph.getCTP().getPArray(0).getRArray(0).getDrawing().getInlineArray(0); inline.setDistT(Units.toEMU(100)); // 距离顶部 inline.setDistB(Units.toEMU(100)); // 距离底部 inline.setDistL(Units.toEMU(100)); // 距离左侧 inline.setDistR(Units.toEMU(100)); // 距离右侧
高级技巧与注意事项
-
水印覆盖范围
默认水印仅出现在页眉，可能无法覆盖首页或特定页面，可通过遍历所有页眉或使用XWPFHeader的getType()方法处理不同页面。
-
水印旋转
文本水印可通过run.setTextRotation()旋转角度（0-360度），但需注意POI对旋转的支持有限。 -
性能优化
对于大文档，建议使用SXSSF或流式处理减少内存占用。 -
兼容性处理
- 旧版.doc格式需使用HWPF，API差异较大。
- 不同Word版本（如.docx vs .docx）的页眉结构可能不同，需测试兼容性。
完整示例代码
import org.apache.poi.xwpf.usermodel.*;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.*;
import java.io.*;
public class WordWatermark {
public static void main(String[] args) throws Exception {
XWPFDocument document = new XWPFDocument(new FileInputStream("input.docx"));
addTextWatermark(document, "内部资料");
try (FileOutputStream out = new FileOutputStream("output.docx")) {
document.write(out);
}
}
public static void addTextWatermark(XWPFDocument doc, String text) {
XWPFHeader header = doc.getHeaderFooterPolicy().getDefaultHeader();
if (header == null) header = doc.createHeader(HeaderFooterType.DEFAULT);
XWPFParagraph paragraph = header.createParagraph();
paragraph.setAlignment(ParagraphAlignment.CENTER);
XWPFRun run = paragraph.createRun();
run.setText(text);
run.setFontSize(48);
run.setColor("DDDDDD");
run.setBold(true);
CTP ctP = paragraph.getCTP();
CTTextCharacterProperties runProps = ctP.getPArray(0).getRArray(0).addNewRPr();
runProps.setAlpha(20000); // 20%透明度
}
}
通过Java为Word文档添加水印，核心在于利用POI操作页眉页脚，文本水印适合简单标识，图片水印适合复杂图形，实际开发中需根据需求调整样式、位置和透明度，并注意文档版本的兼容性，掌握这些技巧后，可灵活应用于文档自动化处理场景,提升工作效率。
