前言
使用java按模板导出word,有很多方案,比如freemarker,jacob,openoffice,apache poi等,其中比较常用的是freemarker导出,但是必须把预先做好的word模板转换成xml格式(ooxml)并且要到xml中找到需要循环的位置,插入freemarker的循环语法表达式,每次模板一变动都要重新做模板,比较不友好,其次就是poi,这个开源框架对excel支持多,对word支持少一点。由于最近遇到需要根据模板导出word文档,所以这里记录一下
提示:以下是本篇文章正文内容,下面案例可供参考
一、环境
是基于Apache POI上实现,官方文档上描述的还是相当详细的,有各种需求的基本实现。
Poi-tl官方文档:http://deepoove.com/poi-tl/
<!-- 导出word的依赖-->
<dependency>
<groupId>com.deepoove</groupId>
<artifactId>poi-tl</artifactId>
</dependency>
<!-- poi的依赖-->
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>4.1.2</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml-schemas</artifactId>
<version>4.1.2</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>4.1.2</version>
</dependency>
二、使用步骤
1.创建word模板
poi-tl是一种无逻辑「logic-less」的模板引擎,没有复杂的控制结构和变量赋值,只有标签。标签由前后两个大括号组成,例如:{{title}} 是指属性名为title的文本标签,详细介绍,可以查看官方文档
Poi-tl官方文档:http://deepoove.com/poi-tl/
名称 | 标签 | 描述 |
---|---|---|
文本 | {{var}} | 文本内容,包括样式文本,纯文本等 |
图片 | {{@var}} | 图片标签以@开始 |
表格 | {{#var}} | 表格标签以#开始 |
列表 | {{*var}} | 列表标签以*开始 |
区块对 | {{?sections}}{{/sections}} | 区块对由前后两个标签组成,开始标签以?标识,结束标签以/标识,可以用作多次渲染 |
嵌套 | {{+var}} | 嵌套又称为导入、包含或者合并,以+标识 |
了解标签之后,可以创建work模板,然后自己匹配字段名,例如
2.读入数据
编写代码,根据模板所填写的属性去填充数值。
demo查看:
Poi-tl根据Word模板动态生成word
Poi-tl根据Word模板动态生成word(其他需求)
java通过poi-tl使用word模版生成word文件
总结
poi-tl这个对于生成work来说,使用相当方便,最常见的文本、word填充图片、列表数据等使用方法都比较简单,根据标签去做匹配就可以。