文章目录

• 前言
• what poi-tl
• why poi-tl
• How poi-tl
• • 1. 版本问题
  • 2. 集成和使用
  • 3. SpringEL表达式
• 总结

前言

开发时, 我们有时需要进行word类型表格导出,
而对于表格操作. 我们一般可能会倾向于使用 poi 进行操作. 但poi操作比较复杂,
所以就在寻找一种可以快速将内容填充到表格中的工具. 而pot-tl 恰好满足了我们这一需求.

what poi-tl

poi-tl（poi template language）是Word模板引擎，使用Word模板和数据创建很棒的Word文档.
在文档的任何地方做任何事情（Do Anything Anywhere）是poi-tl的星辰大海. 官方文档

why poi-tl

poi-tl是一个基于Apache POI的Word模板引擎，也是一个免费开源的Java类库，你可以非常方便的加入到你的项目中，并且拥有着让人喜悦的特性.

注意: 只能操作.docx格式的word，不能操作.doc格式的word. 只能操作word中的表格, 不能操作Excel中的表格

How poi-tl

1. 版本问题

在使用poi-tl时, 需要注意版本之间的冲突问题. 下面我们将使用1.10.x版本, 因此其他环境为: jdk1.8, poi:4.1.2

• 当前版本 1.12.0 Documentation，Apache POI5.2.2+，JDK1.8+
• 1.11.x Documentation，Apache POI5.1.0+，JDK1.8+
• 1.10.x Documentation，Apache POI4.1.2，JDK1.8+
• 1.10.3 Documentation，Apache POI4.1.2，JDK1.8+
• 1.9.x Documentation，Apache POI4.1.2，JDK1.8+
• 1.8.x Documentation，Apache POI4.1.2，JDK1.8+
• 1.7.x Documentation，Apache POI4.0.0+，JDK1.8+
• 1.6.x Documentation，Apache POI4.0.0+，JDK1.8+
• 1.5.x Documentation，Apache POI3.16+，JDK1.6+

V1.12.0版本作了一个不兼容的改动，升级的时候需要注意：

• 重构了PictureRenderData，改为抽象类，建议使用Pictures工厂方法来创建图片数据

2. 集成和使用

2.1 pom文件坐标

		
org.apache.poipoi4.1.2

org.apache.poipoi-ooxml4.1.2

org.apache.poipoi-ooxml-schemas4.1.2

com.deepoovepoi-tl1.10.0

2.2 测试代码-map方式(最简单实用)
复杂表格中, 可以使用这种方式进行依次填充

@Test
public void TestPoiTi() throws IOException {//===================使用Map的方式================================//创建目标文件C:\Users\Administrator\DocumentsResource resource = new ClassPathResource("static/" + "poi_ti_test.docx");File sourceFile = resource.getFile();//构建数据Map data = new HashMap();data.put("name", "江江");data.put("dept", "重机部");data.put("level", "工程师");data.put("leader", "思必达");//创建输出流OutputStream os = new FileOutputStream("template1_out.docx");//最终编译渲染并输出XWPFTemplate.compile(sourceFile).render(data).writeAndClose(os);System.out.println("输出完毕");}

创建表格模板

填充效果

2.3 行循环的形式
需要在Configure对象中绑定需要循环的list对象

//创建行循环策略
LoopRowTableRenderPolicy rowTableRenderPolicy = new LoopRowTableRenderPolicy();
//告诉模板引擎，要在employees做行循环,绑定行循环策略
Configure configure = Configure.builder().bind("employees", rowTableRenderPolicy).build();
//创建目标文件
Resource resource = new ClassPathResource("static/" + "poi_ti_test2.docx");
File sourceFile = resource.getFile();
//构建数据
Map data = new HashMap();//1.学生数据
List employees = new ArrayList<>();
Employee e = new Employee("江江", "重机部", "工程师", "思必达");
Employee e2 = new Employee("江江2", "重机部2", "工程师2", "思必达2");
employees.add(e);
employees.add(e2);
//2.设置到students字段中
data.put("employees", employees);
//创建输出流
OutputStream os = new FileOutputStream("template2_out.docx");
//最终编译渲染并输出
XWPFTemplate.compile(sourceFile, configure).render(data).writeAndClose(os);

创建表格模板

填充效果

2.4 通过模板写入, 并通过浏览器或请求返回

public void downloadDispatchList(Integer carReserveId, HttpServletResponse response) throws IOException {//用于填充的数据体CarReserveVO carReserveVO = getCarReserveVOById(carReserveId);org.springframework.core.io.Resource resource = new ClassPathResource("static/" + "模板文件.docx");File sourceFile = resource.getFile();//在模板文件中任意表格位置填充数据Map data = new HashMap();data.put("ycbm", carReserveVO.getCarUserDept());data.put("ycr", carReserveVO.getCarUserName());data.put("start_time", new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(carReserveVO.getBookerStartTime()));data.put("end_time", new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(carReserveVO.getBookerEndTime()));//浏览器端下载response.setCharacterEncoding("utf-8");response.setContentType("application/msword");String fileName = carReserveVO.getCarUserName() + "的用车申请单" + ".docx";response.setHeader("Content-Disposition", "attachment;filename=".concat(String.valueOf(URLEncoder.encode(fileName, "UTF-8"))));response.flushBuffer();BufferedInputStream bis = new BufferedInputStream(new FileInputStream(sourceFile));//创建输出流OutputStream os = response.getOutputStream();//最终编译渲染并输出XWPFTemplate.compile(sourceFile).render(data).writeAndClose(os);byte[] buffer = new byte[1024];int i = bis.read(buffer);while (i != -1) {os.write(buffer, 0, i);i = bis.read(buffer);}if (bis != null) {bis.close();}
}

表格模板

填充效果

3. SpringEL表达式

Spring Expression Language 是一个强大的表达式语言，支持在运行时查询和操作对象图，可作为独立组件使用，也可作为poi-tl模板上, 用于模板填充时参数的引用. 单独使用时需要引入相应的依赖：

org.springframeworkspring-expression5.3.18

关于SpringEL的写法可以参见官方文档，下面给出一些典型的示例

{{name}}
{{name.toUpperCase()}} 		类方法调用，转大写
{{name == 'poi-tl'}} 		判断条件
{{empty?:'这个字段为空'}}	
{{sex ? '男' : '女'}}   	   三目运算符
{{new java.text.SimpleDateFormat('yyyy-MM-dd HH:mm:ss').format(time)}}  类方法调用，时间格式化
{{price/10000 + '万元'}} 		运算符
{{dogs[0].name}} 			 数组列表使用下标访问
{{localDate.format(T(java.time.format.DateTimeFormatter).ofPattern('yyyy年MM月dd日'))}}  使用静态类方法

总结

根据poi-tl 可以操作含有多种类型的复杂 Word 文档, 包括:文本, 表格, 图片, 附件. markdown等.
并且支持表格行循环, 表格列循环, 动态表格, 批注, 附件, 高亮等等.
更多使用方式可以参照 官方文档, 或者 C站某大佬的一篇使用教程,
后续如有其他需求我也将在本文进行持续更新. 下次见~