Java怎样实现将数据导出为Word文档

文章首发于我的博客：Java怎样实现将数据导出为Word文档 - Liu Zijian's Blog
我们在开发一些体系的时候，比方OA体系，常常能遇到将审批单数据导出为word和excel文档的需求，导出为excel是比力简单的，由于excel有单元格来供我们定位数据位置，但是word文档的格式不像表格那样可以轻松的定位，要想将数据导出为一些带有图片和表格的这种结构复杂的word文档该怎样实现呢。
poi-tl [1]是一款可以帮助我们实现这种功能的Java开源项目，它把POI和Freemarker相联合，可以基于我们绘制好的word文档模板来填凑数据进去，然后生成新的word文档。poi-tl托管在GitHub：https://github.com/Sayi/poi-tl
比方，我们要生成一个差旅行程单，首先要绘制这样的一个word文档模板，用{{name}}代表姓名进行占位，姓名就是普通笔墨类型，以此类推。tripList作为渲染行程表格的数据源的名字，是ArrayList聚集类型，放在表格的表头，用[from]表现tripList聚集中每个元素的from属性的值，渲染到当前行的某一列上，以此类推。最后的三个签署对应的是领导的署名笔迹图片，图片类型要用变量名前多一个@的形式{{@****Pin}}来表现

如果表格中某一列是图片，则表现为[@变量]

模板绘制好以后，开始使用poi-tl工具生成word文档，首先新建maven项目，引入poi-tl的依赖和需要的其他依赖，然后将这个绘制好的word模板文件放在工程的根目录下

1. <?xml version="1.0" encoding="UTF-8"?>
2. <project xmlns="http://maven.apache.org/POM/4.0.0"
3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
5.     <modelVersion>4.0.0</modelVersion>
7.     <groupId>org.example</groupId>
8.     <artifactId>poi-tl</artifactId>
9.     <version>1.0-SNAPSHOT</version>
11.     <properties>
12.         <maven.compiler.source>8</maven.compiler.source>
13.         <maven.compiler.target>8</maven.compiler.target>
14.         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
15.     </properties>
17.     <dependencies>
18.         <dependency>
19.             <groupId>com.deepoove</groupId>
20.             <artifactId>poi-tl</artifactId>
21.             <version>1.12.2</version>
22.         </dependency>
24.         <dependency>
25.             <groupId>org.projectlombok</groupId>
26.             <artifactId>lombok</artifactId>
27.             <version>1.18.24</version>
28.             <scope>provided</scope>
29.         </dependency>
30.     </dependencies>
32. </project>

复制代码

然后，新建一个Entity类: org.example.TravelApplyExportVO

1. package org.example;
3. import com.deepoove.poi.data.PictureRenderData;
4. import lombok.AllArgsConstructor;
5. import lombok.Data;
6. import lombok.NoArgsConstructor;
8. import java.util.ArrayList;
9. import java.util.List;
11. @Data
12. @AllArgsConstructor
13. @NoArgsConstructor
14. public class TravelApplyExportVO {
15.     private String no;
16.     private String name;
17.     private String dept;
18.     private String employeeNo;
19.     private String start;
20.     private String end;
21.     private String days;
22.     private String address;
23.     private String reason;
24.     /**
25.      * com.deepoove.poi.data.PictureRenderData 代表图片
26.      */
27.     private PictureRenderData applyPin;
28.     private PictureRenderData bossPin;
29.     private PictureRenderData leaderPin;
31.     private String date;
33.     /**
34.      * 用于渲染表格的集合
35.      */
36.     private List<Route> tripList = new ArrayList<>();
38.     @Data
39.     @AllArgsConstructor
40.     @NoArgsConstructor
41.     public static class Route {
42.         private String from;
43.         private String to;
44.         private String flight;
45.         private String depTime;
46.         private String arrTime;
47.         private String cabin;
48.     }
49. }

复制代码

新建测试类: org.example.Main，用poi-tl组件基于刚刚绘制的word模板生成一个差旅行程单

1. package org.example;
3. import com.deepoove.poi.XWPFTemplate;
4. import com.deepoove.poi.config.Configure;
5. import com.deepoove.poi.data.PictureRenderData;
6. import com.deepoove.poi.data.Pictures;
7. import com.deepoove.poi.plugin.table.LoopRowTableRenderPolicy;
8. import lombok.SneakyThrows;
11. import java.nio.file.Files;
12. import java.nio.file.Paths;
13. import java.util.ArrayList;
15. public class Main {
17.     @SneakyThrows
18.     public static void main(String[] args) {
20.         TravelApplyExportVO vo = new TravelApplyExportVO();
21.         vo.setNo("202500001");
22.         vo.setName("lzj");
23.         vo.setDept("技术部");
24.         vo.setEmployeeNo("00000001");
25.         vo.setStart("2025-01-01");
26.         vo.setEnd("2025-02-01");
27.         vo.setDays("30");
28.         vo.setAddress("中国香港");
29.         vo.setReason("系统维护");
31.         // 在项目根路径读取笔迹图片，并设置大小
32.         PictureRenderData data1 = Pictures.ofBytes(Files.readAllBytes(Paths.get("img2.png")))
33.                 .size(120, 60)
34.                 .create();
36.         PictureRenderData data2 = Pictures.ofBytes(Files.readAllBytes(Paths.get("img.png")))
37.                 .size(120, 60)
38.                 .create();
40.         PictureRenderData data3 = Pictures.ofBytes(Files.readAllBytes(Paths.get("img.png")))
41.                 .size(120, 60)
42.                 .create();
44.         vo.setApplyPin(data1 );
45.         vo.setBossPin( data2);
46.         vo.setLeaderPin( data3);
48.         vo.setDate("2025-01-10");
50.         // 行程List，最终渲染到文档的表格中
51.         vo.setTripList(new ArrayList<TravelApplyExportVO.Route>() {
52.             {
53.                 add(new TravelApplyExportVO.Route("BJX","ZQZ","ZH5643","2025-01-01 15:00","2025-01-01 16:00","E"));
54.                 add(new TravelApplyExportVO.Route("ZQZ","CDE","JUH6532","2026-01-01 15:00","2025-12-01 16:00","A"));
55.                 add(new TravelApplyExportVO.Route("BJX","ZQZ","KJU0954","2027-01-01 15:00","2025-05-01 16:00","Q"));
56.             }
57.         });
59.         LoopRowTableRenderPolicy policy = new LoopRowTableRenderPolicy();
61.         // !!将tripList通过表格来渲染
62.         Configure config = Configure.builder()
63.                 .bind("tripList", policy)
64.                 .build();
66.         XWPFTemplate template = XWPFTemplate
67.                 .compile("模板.docx", config)
68.                 .render(vo);
70.         template.writeAndClose(Files.newOutputStream(Paths.get("output.docx")));
71.     }
72. }

复制代码

然后领导署名笔记图片素材img.png,img2.png也需要放进工程根目录下
都完成后，执行main()方法测试，步伐运行结束后，将在根路径生成文件output.docx，打开就是我们想要的效果了。

文章写到这已经是深夜了，最新在开发一个OA体系，需要Word导出的场景很多，由于之前没怎么接触过，于是熬夜攻关了一下并记录了下来，接下来渴望项目能顺利交付吧~

参考

---

• https://deepoove.com/poi-tl/ ↩︎
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。