Java基于iText7实现PDF添加通用文本水印的示例详解

<dependencies>
    <!-- iText7 主依赖（PDF 内核） -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>itext7-core</artifactId>
        <version>7.2.5</version>
        <type>pom</type>
    </dependency>
​
    <!-- 可选：中文字体支持（也可以使用自带 TTF 字体文件） -->
    <dependency>
        <groupId>com.itextpdf</groupId>
        <artifactId>font-asian</artifactId>
        <version>7.2.5</version>
    </dependency>
</dependencies>

import com.itextpdf.io.font.PdfEncodings;
import com.itextpdf.kernel.colors.DeviceRgb;
import com.itextpdf.kernel.font.PdfFont;
import com.itextpdf.kernel.font.PdfFontFactory;
import com.itextpdf.kernel.geom.Rectangle;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfReader;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Paragraph;
import com.itextpdf.layout.properties.TextAlignment;
import com.itextpdf.layout.properties.VerticalAlignment;
​
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
​
public class PdfWatermarkUtil {
​
    /**
     * 为 PDF 每一页添加斜向文字水印
     *
     * @param pdfInput     原始 PDF 输入流
     * @param watermark    水印文本（如 "xx公司"）
     * @return 带水印 PDF 的字节数组
     */
    public static byte[] addTextWatermark(InputStream pdfInput, String watermark) throws Exception {
        try (ByteArrayOutputStream out = new ByteArrayOutputStream()) {
            PdfReader reader = new PdfReader(pdfInput);
            PdfWriter writer = new PdfWriter(out);
            PdfDocument pdfDoc = new PdfDocument(reader, writer);
            Document document = new Document(pdfDoc);
​
            PdfFont font = createFont();
​
            int totalPages = pdfDoc.getNumberOfPages();
            for (int i = 1; i <= totalPages; i++) {
                Rectangle pageSize = pdfDoc.getPage(i).getPageSize();
                float x = (pageSize.getLeft() + pageSize.getRight()) / 2;
                float y = (pageSize.getTop() + pageSize.getBottom()) / 2;
​
                Paragraph p = new Paragraph(watermark)
                        .setFont(font)
                        .setFontSize(60)
                        .setFontColor(new DeviceRgb(192, 192, 192))
                        .setOpacity(0.3f);
​
                document.showTextAligned(
                        p,
                        x, y, i,
                        TextAlignment.CENTER,
                        VerticalAlignment.MIDDLE,
                        (float) Math.toRadians(45)
                );
            }
​
            document.close();
            pdfDoc.close();
            return out.toByteArray();
        }
    }
​
    /**
     * 创建字体（示例：使用系统或自带的中文字体）
     */
    private static PdfFont createFont() throws Exception {
        // 示例：使用内置字体或自带 TTF 文件
        // 1）若有自定义字体：
        // return PdfFontFactory.createFont("/path/to/simsun.ttf", PdfEncodings.IDENTITY_H, true);
        // 2）简化示例：使用内置字体（不保证完整中文支持）
        return PdfFontFactory.createFont("STSong-Light", "UniGB-UCS2-H", true);
    }
}