Java基于的Spire.Doc实现Word文档(DOC/DOCX)文字水印添加_Java

本文介绍如何在 java 中为 word 文档（.doc、.docx）添加页面文字水印，示例基于 spire.doc for java，侧重通用实现方式，不依赖具体业务代码。

1. 方案概览

目标：在 word 文档的每一页添加斜向、浅灰色的文字水印（例如「xx公司」），以页面水印的形式呈现，不直接修改正文内容。

适用格式：.doc、.docx（如需 .wps 等其他格式，可按同样思路扩展）。

核心技术栈：

java 8+；
spire.doc for java（本文使用其 free 版本作为示例）。

2. maven 依赖与仓库示例

<dependencies>
    <!-- spire.doc for java（free 版本示例，版本号可按需调整） -->
    <dependency>
        <groupid>e-iceblue</groupid>
        <artifactid>spire.doc.free</artifactid>
        <version>5.2.0</version>
    </dependency>
</dependencies>

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>

生产环境可根据许可证选择付费或更新版本，并统一管理版本号。

3. 实现思路

使用 spire.doc 的 document 类从文件或输入流加载 word 文档：

docx：loadfromstream(..., fileformat.docx)；
doc：loadfromstream(..., fileformat.doc)；
或使用 loadfromfile(...) 从物理文件加载。

构造一个 textwatermark 对象，设置水印文本、字号、颜色和布局。

通过文档的 section 对象获取 document 并调用 setwatermark(textwatermark) 应用水印：官方推荐用 document.getsections().get(0).getdocument().setwatermark(...)。

以相应的 fileformat 保存文档到新文件或输出流，得到带水印的 doc/docx。

4. 示例一：为 docx 文档添加文字水印

4.1 从文件加载并输出到新文件

import com.spire.doc.document;
import com.spire.doc.fileformat;
import com.spire.doc.textwatermark;
import com.spire.doc.documents.watermarklayout;

import java.awt.color;

public class docxwatermarkexample {

    public static void addwatermarktodocx(string inputpath, string outputpath, string watermarktext) {
        // 1. 加载 docx 文档
        document document = new document();
        document.loadfromfile(inputpath, fileformat.docx);

        // 2. 创建文字水印
        textwatermark watermark = new textwatermark();
        watermark.settext(watermarktext);              // 如："xx公司"
        watermark.setfontsize(40);                     // 字号
        watermark.setcolor(color.lightgray);           // 颜色
        watermark.setlayout(watermarklayout.diagonal); // 斜对角

        // 3. 通过 section 的 document 设置水印（官方推荐方式）
        if (document.getsections().getcount() > 0) {
            document.getsections().get(0).getdocument().setwatermark(watermark);
        } else {
            // 极端情况下没有 section，可退回到直接设置
            document.setwatermark(watermark);
        }

        // 4. 保存为新的 docx
        document.savetofile(outputpath, fileformat.docx);
        document.close();
    }
}

4.2 从输入流到字节数组（适用于 web 上传/下载场景）

import com.spire.doc.document;
import com.spire.doc.fileformat;
import com.spire.doc.textwatermark;
import com.spire.doc.documents.watermarklayout;

import java.awt.color;
import java.io.bytearrayoutputstream;
import java.io.inputstream;

public class docxwatermarkutil {

    public static byte[] addwatermarktodocx(inputstream inputstream, string watermarktext) throws exception {
        try (bytearrayoutputstream out = new bytearrayoutputstream()) {
            document document = new document();
            document.loadfromstream(inputstream, fileformat.docx);

            textwatermark watermark = new textwatermark();
            watermark.settext(watermarktext);
            watermark.setfontsize(40);
            watermark.setcolor(color.lightgray);
            watermark.setlayout(watermarklayout.diagonal);

            if (document.getsections().getcount() > 0) {
                document.getsections().get(0).getdocument().setwatermark(watermark);
            } else {
                document.setwatermark(watermark);
            }

            document.savetostream(out, fileformat.docx);
            document.close();
            return out.tobytearray();
        }
    }
}

5. 示例二：为 doc 文档添加文字水印

doc 文档与 docx 实现方式基本相同，仅在 fileformat 上有所差异。

import com.spire.doc.document;
import com.spire.doc.fileformat;
import com.spire.doc.textwatermark;
import com.spire.doc.documents.watermarklayout;

import java.awt.color;
import java.io.bytearrayoutputstream;
import java.io.inputstream;

public class docwatermarkutil {

    public static byte[] addwatermarktodoc(inputstream inputstream, string watermarktext) throws exception {
        try (bytearrayoutputstream out = new bytearrayoutputstream()) {
            document document = new document();
            document.loadfromstream(inputstream, fileformat.doc);

            textwatermark watermark = new textwatermark();
            watermark.settext(watermarktext);
            watermark.setfontsize(40);
            watermark.setcolor(color.lightgray);
            watermark.setlayout(watermarklayout.diagonal);

            if (document.getsections().getcount() > 0) {
                document.getsections().get(0).getdocument().setwatermark(watermark);
            } else {
                document.setwatermark(watermark);
            }

            document.savetostream(out, fileformat.doc);
            document.close();
            return out.tobytearray();
        }
    }
}

6. 关键点与实践建议

水印文本设计：可以是固定文案（如「xx公司」「内部资料」），也可以结合用户名、时间戳、ip 等生成个性化水印，便于追责和防泄露。

查看模式：word 中建议使用「打印布局」查看水印；在某些阅读模式下水印可能被隐藏。

free 版本限制：spire.doc free 版对于页数或功能有一定限制，大规模生产使用时建议评估付费版本或其他库。

与业务集成：

上传文件时在写入存储（本地/对象存储）前先加水印；
或在线预览/下载前临时生成带水印副本，不改变原始文件；
可以按租户、用户级别配置不同水印策略。

性能考虑：对于大体积 word 文档，建议在后台任务中进行水印处理，避免阻塞同步接口。

7. 总结

使用 spire.doc 在 java 中为 word 文档添加页面文字水印，核心是：加载文档 → 构造 textwatermark → 通过 section/document 设置水印 → 以对应格式保存。上述示例将输入输出封装为 inputstream/byte[] 或文件路径形式，方便在上传、下载或批处理场景中复用，实现对 doc/docx 文档的统一水印控制。

到此这篇关于java基于的spire.doc实现word文档(doc/docx)文字水印添加的文章就介绍到这了,更多相关java word添加文字水印内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！