Java 使用 poi 和 aspose 实现 word 模板数据写入并转换 pdf 增加水印

本项目所有源码和依赖资源都在文章顶部链接，有需要可以下载使用

1. 需求描述

---

1. 从指定位置读取一个 word 模板
2. 获取业务数据并写入该 word 模板，生成新的 word 文档
3. 将新生成的 word 文档转换为 pdf 格式
4. 对 pdf 文档添加水印

2. 效果预览

---

1. word 模板
   
2. 带水印的 pdf 文档
   

3. 实现思路

---

• word 模板数据写入：使用 poi-tl 库实现
• word 转 pdf 格式：aspose-words 库实现
• pdf 增加水印：aspose-pdf 库实现

4. 实现过程

---

4.1 依赖库准备

poi-tl 可以使用 maven 直接从中央仓库下载，但是 aspose 无法下载，需要从网上下载 jar 包并导入本地仓库

• poi-tl

      <dependency>
          <groupId>com.deepoovegroupId>
          <artifactId>poi-tlartifactId>
          <version>1.12.1version>
      dependency>
  1
  2
  3
  4
  5

• aspose-word
  将 jar 包导入本地仓库

      mvn install:install-file \
        -DgroupId="com.aspose" \
        -DartifactId="aspose-words" \
        -Dversion="15.8.0" \
        -Dpackaging="jar" \
        -Dfile="aspose-words-15.8.0-jdk16.jar"
  1
  2
  3
  4
  5
  6

  项目中添加依赖

      <dependency>
          <groupId>com.asposegroupId>
          <artifactId>aspose-wordsartifactId>
          <version>15.8.0version>
      dependency>
  1
  2
  3
  4
  5

• aspose-pdf
  将 jar 包导入本地仓库

      mvn install:install-file \
        -DgroupId="com.aspose" \
        -DartifactId="aspose-pdf" \
        -Dversion="17.8" \
        -Dpackaging="jar" \
        -Dfile="aspose.pdf-17.8.jar"
  1
  2
  3
  4
  5
  6

  项目中添加依赖

      <dependency>
          <groupId>com.asposegroupId>
          <artifactId>aspose-pdfartifactId>
          <version>17.8version>
      dependency>
  1
  2
  3
  4
  5

• license.xml
  由于 aspose 库分为免费版和收费版，免费版导出的文档带有试用水印，所以需要添加 license.xml，版权关系不在文章中写出，有需要的可以下载文章顶部链接的完整源码包。

4.2 核心实现方法

@SpringBootApplication
public class Word2PDFApplication {

    public static void main(String[] args) {

        SpringApplication.run(Word2PDFApplication.class, args);

        // word 模板
        String wordTemplatePath = "src/main/resources/templates/简历模板.docx";
        // 写入数据后的 word
        String wordOutputPath = "src/main/resources/templates/简历模板-output.docx";
        // word 转换为 pdf
        String pdfOutputPath = "src/main/resources/templates/简历模板.pdf";
        // pdf 增加水印
        String pdfWithMarkerOutputPath = "src/main/resources/templates/简历模板-marker.pdf";

        // step 1: 封装模板数据
        Map<String, Object> dataMap = getPersonDataMap();

        // step 2: 将数据写入 word 模板
        writeDataToWord(dataMap, wordTemplatePath, wordOutputPath);

        // step 3: 将 word 转换为 pdf
        convertWordToPdf(wordOutputPath, pdfOutputPath);

        // step 4: 将 pdf 增加水印
        addMarkerToPdf(pdfOutputPath, pdfWithMarkerOutputPath);
    }

	// 封装业务数据，用于填入模板对应占位符中
    private static Map<String, Object> getPersonDataMap() {
        Map<String, Object> personDataMap = new HashMap<>();
        personDataMap.put("name", "张三");
        personDataMap.put("sex", "男");
        personDataMap.put("birthDate", "1998-12-02");
        personDataMap.put("id", "420202199812020011");
        personDataMap.put("phone", "18819297766");
        personDataMap.put("skills", "java Spring MySQL ...");
        return personDataMap;
    }

	// 将业务数据写入 word 模板，并生成新的 word 文件
    private static void writeDataToWord(Map<String, Object> dataMap, String wordTemplatePath, String wordOutputPath) {

        XWPFTemplate render = XWPFTemplate.compile(wordTemplatePath).render(dataMap);
        File dest = new File(wordOutputPath);
        if (!dest.getParentFile().exists()) {
            dest.getParentFile().mkdirs();
        }
        try {
            render.writeToFile(wordOutputPath);
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }

	// 将新生成的带有业务数据的 word 文档转换为 pdf 格式
    private static void convertWordToPdf(String wordOutputPath, String pdfOutputPath) {
        // 验证 License 若不验证则转化出的 pdf 文档带有水印
        if (!getAsposeWordLicense()) {
            return;
        }
        FileOutputStream os = null;
        try {
            long old = System.currentTimeMillis();
            File file = new File(pdfOutputPath);
            os = new FileOutputStream(file);
            Document doc = new Document(wordOutputPath);
            doc.save(os, SaveFormat.PDF);
            long now = System.currentTimeMillis();
            System.out.println("pdf转换成功，共耗时：" + ((now - old) / 1000.0) + "秒");
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (os != null) {
                try {
                    os.flush();
                    os.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
    }

	// 对转换后的 pdf 文档添加水印效果
    private static void addMarkerToPdf(String pdfOutputPath, String pdfWithMarkerOutputPath) {
        // 验证 License 若不验证则增加水印后的 pdf 文档带有试用水印
        boolean asposePdfLicense = getAsposePdfLicense();
        if (!asposePdfLicense) {
            return;
        }

        com.aspose.pdf.Document pdfDocument = new com.aspose.pdf.Document(pdfOutputPath);

        TextStamp textStamp = new TextStamp("水印文本");
        textStamp.getTextState().setFontSize(14.0F);
        textStamp.getTextState().setFontStyle(FontStyles.Bold);
        textStamp.setRotateAngle(45);
        textStamp.setOpacity(0.2);

        // 设置水印间距
        float xOffset = 100;
        float yOffset = 100;

        // 添加水印到每一页
        for (Page page : pdfDocument.getPages()) {
            float xPosition = 0;
            float yPosition = 0;

            // 在页面上添加水印直到页面被覆盖
            while (yPosition < page.getRect().getHeight()) {
                textStamp.setXIndent(xPosition);
                textStamp.setYIndent(yPosition);
                page.addStamp(textStamp);

                xPosition += xOffset;

                // 如果水印超过页面宽度，移到下一行
                if (xPosition + textStamp.getWidth() > page.getRect().getWidth()) {
                    xPosition = 0;
                    yPosition += yOffset;
                }
            }
        }
        // 保存修改后的文档
        pdfDocument.save(pdfWithMarkerOutputPath);
    }

	// 验证 license，否则有试用水印
    private static boolean getAsposeWordLicense() {
        boolean result = false;
        InputStream is = null;
        try {
            ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
            org.springframework.core.io.Resource[] resources = resolver.getResources("classpath:license.xml");
            is = resources[0].getInputStream();
            License asposeLic = new License();
            asposeLic.setLicense(is);
            result = true;
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (is != null) {
                try {
                    is.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
        return result;
    }

	// 验证 license，否则有试用水印
    private static boolean getAsposePdfLicense() {
        boolean result = false;
        InputStream is = null;
        try {
            ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
            org.springframework.core.io.Resource[] resources = resolver.getResources("classpath:license.xml");
            is = resources[0].getInputStream();
            com.aspose.pdf.License asposeLic = new com.aspose.pdf.License();
            asposeLic.setLicense(is);
            result = true;
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (is != null) {
                try {
                    is.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
        return result;
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179