Java表格加水印技巧全解析

本文深入解析了在Java中为表格文件添加水印的两种主流方案：针对Excel使用Apache POI通过页眉页脚或浮动元素模拟水印（如居中显示“【机密】”），虽简便但视觉效果有限；针对PDF则推荐iText7，在每页精准叠加可调字体、旋转角度与透明度的斜向半透明文字水印，真正实现专业级视觉呈现与文档安全控制——尤其强调正式交付时优先选用PDF方案，兼顾美观性、兼容性与防篡改能力，是Java开发者处理敏感表格导出需求的实用指南。

在Java中为表格添加水印，通常是指在导出的Excel或PDF表格文件上叠加文字或图像水印。Java本身不直接操作“可视化表格”，而是通过操作文档生成来实现水印效果。以下是针对常见格式（Excel和PDF）的具体实现方式。

1. 为Excel文件添加水印

使用 Apache POI 操作Excel时，由于Excel本身没有“水印”功能（不像Word），需要手动在页眉/页脚或浮动文本框中模拟水印效果。

说明与建议：

• 在Excel中添加水印最常用的方法是通过设置页眉和页脚插入文字，打印时可见。
• 也可以在工作表顶层插入一个半透明的文本框，但需注意导出后是否支持显示。

示例：通过页脚添加“机密”水印

```java import org.apache.poi.ss.usermodel.*; import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import java.io.FileOutputStream;

public class ExcelWatermark { public static void main(String[] args) throws Exception { Workbook workbook = new XSSFWorkbook(); Sheet sheet = workbook.createSheet("数据表");

    // 添加一些数据
    Row row = sheet.createRow(0);
    Cell cell = row.createCell(0);
    cell.setCellValue("姓名");
    cell = row.createCell(1);
    cell.setCellValue("年龄");

    // 设置页脚水印
    Footer footer = sheet.getFooter();
    footer.setCenter("【机密】"); // 居中显示水印文字

    // 也可使用页眉
    Header header = sheet.getHeader();
    header.setRight("打印时间: &D &T"); // 右侧添加时间

    FileOutputStream out = new FileOutputStream("带水印的表格.xlsx");
    workbook.write(out);
    out.close();
    workbook.close();
}

}

注意：这种方式不是视觉上的斜向半透明水印，而是打印时出现在页脚的文字。若要实现更真实的水印，需转为PDF后再处理。

2. 为PDF表格添加水印
使用 iText 或 Apache PDFBox 可以在生成的PDF表格上添加真正的图形水印（如斜向半透明文字）。

推荐使用 iText 实现：

  
支持在每页叠加自定义内容。
  
可控制字体、颜色、透明度、旋转角度，实现美观水印。


示例：用iText7在PDF表格上加水印
```java
import com.itextpdf.kernel.pdf.*;
import com.itextpdf.kernel.pdf.canvas.PdfCanvas;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Table;
import com.itextpdf.layout.element.Cell;
import com.itextpdf.kernel.font.PdfFont;
import com.itextpdf.kernel.font.PdfFontFactory;
import com.itextpdf.kernel.color.ColorConstants;
import com.itextpdf.kernel.geom.PageSize;

import java.io.IOException;

public class PdfTableWithWatermark {
    public static void main(String[] args) throws IOException {
        PdfWriter writer = new PdfWriter("带水印的PDF表格.pdf");
        PdfDocument pdf = new PdfDocument(writer);
        Document document = new Document(pdf, PageSize.A4);

        // 创建表格
        Table table = new Table(2);
        table.addCell(new Cell().add("姓名"));
        table.addCell(new Cell().add("年龄"));
        table.addCell(new Cell().add("张三"));
        table.addCell(new Cell().add("25"));
        document.add(table);

        // 添加水印到每一页
        addWatermark(pdf, "机密");

        document.close();
    }

    private static void addWatermark(PdfDocument pdfDoc, String watermarkText) throws IOException {
        int numberOfPages = pdfDoc.getNumberOfPages();
        PdfFont font = PdfFontFactory.createFont("STSong-Light", "UniGB-UCS2-H"); // 中文字体
        float fontSize = 40;

        for (int i = 1; i <= numberOfPages; i++) {
            PdfPage page = pdfDoc.getPage(i);
            PdfCanvas canvas = new PdfCanvas(page.newContentStreamBefore(), page.getResources(), pdfDoc);

            canvas.saveState();
            canvas.beginText();

            // 设置字体和大小
            canvas.setFontAndSize(font, fontSize);
            canvas.setFillColor(ColorConstants.LIGHT_GRAY);
            canvas.setAlphaStroking(0.5f);
            canvas.setAlphaNonStroking(0.5f);

            // 设置水印位置和旋转（斜向）
            float x = 297; // A4 宽度一半
            float y = 421; // 高度一半
            canvas.setTextMatrix(1, 0.5f, -0.5f, 1, x, y); // 旋转+平移
            canvas.showText(watermarkText);

            canvas.endText();
            canvas.restoreState();
        }
    }
}

3. 综合建议

• 如果输出是Excel，只能模拟水印，适合打印用途；真实视觉水印建议转成PDF。
• 生成PDF时使用iText可精确控制水印样式，适合正式文档场景。
• 注意中文字体支持，避免乱码，需引入字体文件或使用支持中文的字体。
• 水印内容可根据用户、时间、权限动态生成，增强安全性。

基本上就这些。根据你的实际输出格式选择合适的方式，水印的关键在于“叠加层”和“透明度控制”。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。