使用Java POI为Word文档添加水印的指南

在这篇文章中，我们将学习如何使用Java POI库为Word文档添加水印。整个过程可以分为几个步骤，下面的表格总结了这些步骤：

步骤 描述
1 导入必要的Java POI依赖
2 创建Word文档
3 创建水印并添加到文档中
4 保存文档

接下来，我们将逐步介绍每个步骤的详细信息以及相应的代码示例。

1. 导入必要的Java POI依赖

使用Maven时，需要在pom.xml文件中添加以下依赖：

<dependencies>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi-ooxml</artifactId>
        <version>5.2.3</version> <!-- 请根据最新版本进行调整 -->
    </dependency>
    <dependency>
        <groupId>org.apache.poi</groupId>
        <artifactId>poi</artifactId>
        <version>5.2.3</version> <!-- 请根据最新版本进行调整 -->
    </dependency>
</dependencies>

2. 创建Word文档

接下来，通过Java创建一个Word文档。以下是创建文档的代码示例：

import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.apache.poi.xwpf.usermodel.XWPFParagraph;

import java.io.FileOutputStream;
import java.io.IOException;

public class WatermarkExample {
    public static void main(String[] args) {
        //创建Word文档对象
        XWPFDocument document = new XWPFDocument();

        // 添加一段文本
        XWPFParagraph paragraph = document.createParagraph();
        paragraph.createRun().setText("这是一个示例文档。");

        // 保存文档
        try (FileOutputStream out = new FileOutputStream("example.docx")) {
            document.write(out);
            System.out.println("文档创建成功");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

3. 创建水印并添加到文档中

此处，我们将添加水印文本。“水印文本”可以是任何你想要在文档中展示的内容。以下是添加水印的代码：

import org.apache.poi.xwpf.usermodel.XWPFHeader;
import org.apache.poi.xwpf.usermodel.XWPFHeaderFooterPolicy;
import org.apache.poi.xwpf.usermodel.XWPFParagraph;
import org.apache.poi.xwpf.usermodel.XWPFRun;

public class WatermarkExample {
    public static void main(String[] args) {
        //省略前面的代码

        //创建一个水印
        XWPFHeaderFooterPolicy policy = document.createHeaderFooterPolicy();
        // 创建一个头部
        XWPFHeader header = policy.createHeader(XWPFHeaderFooterPolicy.DEFAULT);
        // 在头部添加水印
        XWPFParagraph watermarkParagraph = header.createParagraph();
        XWPFRun watermarkRun = watermarkParagraph.createRun();
        watermarkRun.setText("水印：机密");
        watermarkRun.setBold(true);

        try (FileOutputStream out = new FileOutputStream("watermarked_example.docx")) {
            document.write(out);
            System.out.println("水印添加成功");
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

4. 保存文档

在步骤2和步骤3中，我们已经完成了文档创建和水印添加，并在同一个代码块中保存了文档。

流程图

以下是整个流程的序列图，帮助您更好地理解执行顺序：

sequenceDiagram
    participant User
    participant System
    User->>System: 导入POI依赖
    System->>User: 依赖导入成功
    User->>System: 创建Word文档
    System->>User: 文档创建成功
    User->>System: 添加水印
    System->>User: 水印添加成功
    User->>System: 保存文档
    System->>User: 文档保存成功

总结

通过上述步骤，您不仅学会了如何使用Java POI为Word文档添加水印，还掌握了一些基础的文档操作。希望这一指南可以帮助您在以后的项目中更好地使用POI库。如果有任何问题或者想要深入了解的内容，请随时提问！