根据模板动态生成word（三）使用poi-tl生成word

@
目录

• 一、前言
  
  
  
  • 1、什么是poi-tl
    
  • 2、官方信息
    
    
    
    • 2.1 源码仓库
      
    • 2.2 中文文档
      
    • 2.3 开源协议
      
    
    
  • 3、poi-tl的优势
    
    
    
    • 3.1 poi-tl和其他模板引擎的对比
      
    • 3.2   poi-tl Word模板引擎支持的功能
      
    
    
  
  
• 二、基本的使用配置
  
• 1、引入依赖
  
  
  
  • 
    
    
    
    • 1.1 Maven
      
    • 1.2 Gradle
      
    
    
  • 2、配置
    
    
    
    • 2.1 新建配置
      
    
    
  • 2.2 标签前后缀替换
    
    
    
    • 2.3 加载模板
      
    • 2.4 填充数据
      
    • 2.5 输出文件
      
    
    
  
  
• 三、各类模板标签替换和填充
  
  
  
  • 1 文本
    
    
    
    • 1.1 文本的标签如下
      
    • 1.2 支持数据类型
      
    • 1.3 文本数据填充方式如下
      
    
    
  • 2 图片
    
    
    
    • 2.1 图片的标签如下：
      
    • 2.2 支持数据类型
      
    • 2.3  图片数据填充方式如下
      
    
    
  • 3 表格
    
    
    
    • 3.1 表格的标签如下：
      
    • 3.2 支持数据类型
      
    • 3.3 表格数据填充方式如下
      
    
    
  • 4、列表
    
    
    
    • 4.1 列表的标签如下：
      
    • 4.2 支持数据类型
      
    • 4.3  列表数据填充方式如下
      
    
    
  
  
• 四、验证
  
  
  
  • 1、准备模板
    
  • 2、准备测试代码
    
  • 3、生成效果
    
  
  

一、前言

1、什么是poi-tl

poi-tl是一个基于Apache POI的Word模板引擎，也是一个免费开源的Java类库。同类型的FreeMarker或Velocity基于文本模板和数据生成新的html页面或配置文件。而poi tl是一个基于Word模板和数据生成新文档的Word模板引擎。
Word模板具有丰富的样式。Poi-tl将在生成的文档中完美地保留模板中的样式。也可以设置标记的样式。标记的样式将应用于替换的文本，因此您可以专注于模板设计。
poi-tl是一个“无逻辑”模板引擎。没有复杂的控制结构和变量分配，只有标签，有些标签可以用文本、图片、表格等代替，有些标签会隐藏某些文档内容，而另一些标签会循环一系列文档内容。
像变量赋值或条件语句这样的“强大”构造可以很容易地在模板系统中专门修改应用程序的外观。。。然而，以分离为代价，将模板本身变成应用程序逻辑的一部分。
poi-tl支持自定义函数（插件），函数可以在Word模板的任何地方执行，在文档的任何地方做任何事情都是poi-tl的目标。
2、官方信息

2.1 源码仓库

GitHub - Sayi/poi-tl: Generate awesome word(docx) with template
2.2 中文文档

Poi-tl Documentation (deepoove.com)
2.3 开源协议

Apache License 2.0
3、poi-tl的优势

3.1 poi-tl和其他模板引擎的对比

下面表格是官方文档中提供的与其他模板引擎的对比
方案移植性功能性易用性Poi-tlJava跨平台Word模板引擎，基于Apache POI，提供更友好的API低代码，准备文档模板和数据即可Apache POIJava跨平台Apache项目，封装了常见的文档操作，也可以操作底层XML结构文档不全，这里有一个教程：Apache POI Word快速入门FreemarkerXML跨平台仅支持文本，很大的局限性不推荐，XML结构的代码几乎无法维护OpenOffice部署OpenOffice，移植性较差-需要了解OpenOffice的APIHTML浏览器导出依赖浏览器的实现，移植性较差HTML不能很好的兼容Word的格式，样式糟糕-Jacob、winlibWindows平台-复杂，完全不推荐使用3.2   poi-tl Word模板引擎支持的功能

Word模板引擎功能描述文本将标签渲染为文本图片将标签渲染为图片表格将标签渲染为表格列表将标签渲染为列表图表条形图（3D条形图）、柱形图（3D柱形图）、面积图（3D面积图）、折线图（3D折线图）、雷达图、饼图（3D饼图）、散点图等图表渲染If Condition判断根据条件隐藏或者显示某些文档内容（包括文本、段落、图片、表格、列表、图表等）Foreach Loop循环根据集合循环某些文档内容（包括文本、段落、图片、表格、列表、图表等）Loop表格行循环复制渲染表格的某一行Loop表格列循环复制渲染表格的某一列Loop有序列表支持有序列表的循环，同时支持多级列表Highlight代码高亮word中代码块高亮展示，支持26种语言和上百种着色样式Markdown将Markdown渲染为word文档Word批注完整的批注功能，创建批注、修改批注等Word附件Word中插入附件SDT内容控件内容控件内标签支持Textbox文本框文本框内标签支持图片替换将原有图片替换成另一张图片书签、锚点、超链接支持设置书签，文档内锚点和超链接功能Expression Language完全支持SpringEL表达式，可以扩展更多的表达式：OGNL, MVEL…样式模板即样式，同时代码也可以设置样式模板嵌套模板包含子模板，子模板再包含子模板合并Word合并Merge，也可以在指定位置进行合并用户自定义函数(插件)插件化设计，在文档任何位置执行函数二、基本的使用配置

1、引入依赖

1.1 Maven

1. <dependency>
2.   <groupId>com.deepoove</groupId>
3.   <artifactId>poi-tl</artifactId>
4.   <version>1.12.1</version>
5. </dependency>

复制代码

1.2 Gradle

1. implementation 'com.deepoove:poi-tl:1.12.1'

复制代码

2、配置

2.1 新建配置

1. ConfigureBuilder builder = Configure.builder();

复制代码

2.2 标签前后缀替换

poi-tl所有的标签都是以{{开头，以}}结尾，这是为了致敬Google CTemplate。标签可以出现在任何位置，包括页眉，页脚，表格内部，文本框等，表格布局可以设计出很多优秀专业的文档，推荐使用表格布局。
当然如果你更偏爱freemarker ${} 的方式，也可以添加如下配置修改标签的前后缀配置：

1. builder.buildGramer("${", "}");

复制代码

2.3 加载模板

1. XWPFTemplate template = XWPFTemplate.compile("template.docx", builder.buid());

复制代码

poi-tl加载使用XWPFTemplate.compile方法来加载模板，支持模板以绝对路径（String），File、InputStream、XWPFDocument四种格式传入。
2.4 填充数据

poi-tl数据类似于哈希或者字典，可以是Map结构（key是标签名称）：

1. Map<String, Object> data = new HashMap<>();
2. data.put("name", "Sayi");
3. data.put("start_time", "2019-08-04");
4. template.render(dataMap);

复制代码

2.5 输出文件

poi-tl以流的方式进行输出：

1. template.write(OutputStream stream);

复制代码

可以写到任意输出流中，比如文件流：

1. template.write(new FileOutputStream("output.docx"));

复制代码

如网络流：

1. response.setContentType("application/octet-stream");
2. response.setHeader("Content-disposition","attachment;filename=""+"out_template.docx"+""");
4. // HttpServletResponse response
5. OutputStream out = response.getOutputStream();
6. BufferedOutputStream bos = new BufferedOutputStream(out);
7. template.write(bos);
8. bos.flush();
9. out.flush();
10. PoitlIOUtils.closeQuietlyMulti(template, bos, out);

复制代码

三、各类模板标签替换和填充

1 文本

1.1 文本的标签如下

1. {{var}}

复制代码

1.2 支持数据类型

• String ：文本
  
• TextRenderData ：有样式的文本
  
• HyperlinkTextRenderData ：超链接和锚点文本
  
• Object ：调用 toString() 方法转化为文本
  

1.3 文本数据填充方式如下

代码示例

1. put("name", "Sayi");
2. put("author", new TextRenderData("000000", "Sayi"));
3. put("link", new HyperlinkTextRenderData("website", "http://deepoove.com"));
4. put("anchor", new HyperlinkTextRenderData("anchortxt", "anchor:appendix1"));

复制代码

除了new操作符，还提供了更加优雅的工厂 Texts 和链式调用的方式轻松构建文本模型。
链式代码示例

1. put("author", Texts.of("Sayi").color("000000").create());
2. put("link", Texts.of("website").link("http://deepoove.com").create());
3. put("anchor", Texts.of("anchortxt").anchor("appendix1").create());

复制代码

2 图片

2.1 图片的标签如下：

1. 图片标签以@开始：{{@var}}

复制代码

2.2 支持数据类型

• String ：图片url或者本地路径，默认使用图片自身尺寸
  
• PictureRenderData
  
• ByteArrayPictureRenderData
  
• FilePictureRenderData
  
• UrlPictureRenderData
  

2.3  图片数据填充方式如下

1. // 指定图片路径
2. put("image", "logo.png");
3. // svg图片
4. put("svg", "https://img.shields.io/badge/jdk-1.6%2B-orange.svg");
6. // 设置图片宽高
7. put("image1", Pictures.ofLocal("logo.png").size(120, 120).create());
9. // 图片流
10. put("streamImg", Pictures.ofStream(new FileInputStream("logo.jpeg"), PictureType.JPEG)
11.   .size(100, 120).create());
13. // 网络图片(注意网络耗时对系统可能的性能影响)
14. put("urlImg", Pictures.ofUrl("http://deepoove.com/images/icecream.png")
15.   .size(100, 100).create());
17. // java图片
18. put("buffered", Pictures.ofBufferedImage(bufferImage, PictureType.PNG)
19.   .size(100, 100).create());

复制代码

3 表格

3.1 表格的标签如下：

1. 表格标签以#开始：{{#var}}

复制代码

3.2 支持数据类型

• TableRenderData
  

3.3 表格数据填充方式如下

• 基础表格示例
  

1. // 一个2行2列的表格
2. put("table0", Tables.of(new String[][] {
3.                 new String[] { "00", "01" },
4.                 new String[] { "10", "11" }
5.             }).border(BorderStyle.DEFAULT).create());

复制代码

• 表格样式示例
  

1. // 第0行居中且背景为蓝色的表格
2. RowRenderData row0 = Rows.of("姓名", "学历").textColor("FFFFFF")
3.       .bgColor("4472C4").center().create();
4. RowRenderData row1 = Rows.create("李四", "博士");
5. put("table1", Tables.create(row0, row1));

复制代码

• 表格合并示例
  

1. // 合并第1行所有单元格的表格
2. RowRenderData row0 = Rows.of("列0", "列1", "列2").center().bgColor("4472C4").create();
3. RowRenderData row1 = Rows.create("没有数据", null, null);
4. MergeCellRule rule = MergeCellRule.builder().map(Grid.of(1, 0), Grid.of(1, 2)).build();
5. put("table3", Tables.of(row0, row1).mergeRule(rule).create());

复制代码

4、列表

4.1 列表的标签如下：

1. 列表标签以*开始：{{*var}}

复制代码

4.2 支持数据类型

• List
  
• NumberingRenderData
  

4.3  列表数据填充方式如下

1. put("list", Numberings.create("Plug-in grammar",
2.                     "Supports word text, pictures, table...",
3.                     "Not just templates"));

复制代码

四、验证

1、准备模板

首先我们建立一个word文件，在word文件里填充一下内容。

2、准备测试代码

1. import com.deepoove.poi.XWPFTemplate;
2. import com.deepoove.poi.config.Configure;
3. import com.deepoove.poi.config.ConfigureBuilder;
4. import com.deepoove.poi.data.*;
5. import dto.Qiankuan;
6. import java.io.FileInputStream;
7. import java.io.IOException;
8. import java.nio.file.Files;
9. import java.nio.file.Paths;
10. import java.time.LocalDate;
11. import java.util.*;
13. public class PoitlTest {
15.     public static void main(String[] args) throws IOException {
16.         ConfigureBuilder builder = Configure.builder();
17.         //获取模板的文件流
18.         FileInputStream fileInputStream = new FileInputStream("D:\\文章\\word生成\\poi-tl\\qiantiao.docx");
20.         HashMap<String, Object> dataMap = new HashMap<>();
21.         //添加文本
22.         LocalDate currentDate = LocalDate.now();
23.         LocalDate endDate = currentDate.plusYears(1L);
24.         dataMap.put("debtor", "陈有楚");
25.         dataMap.put("nowYear", String.valueOf(currentDate.getYear()));
26.         dataMap.put("nowMonth", String.valueOf(currentDate.getMonthValue()));
27.         dataMap.put("nowDay", String.valueOf(currentDate.getDayOfMonth()));
28.         //验证换行的情况
29.         dataMap.put("arrears", "\n一顿老魏，\n贵州大黄牛，\nv我50");
30.         dataMap.put("endYear", String.valueOf(endDate.getYear()));
31.         dataMap.put("endMonth", String.valueOf(endDate.getMonthValue()));
32.         dataMap.put("endDay", String.valueOf(endDate.getDayOfMonth()));
33.         //添加列表
34.         List<String> list = Arrays.asList("阿大", "阿二", "阿三");
35.         Numberings.NumberingBuilder numberingBuilder = Numberings.of(NumberingFormat.DECIMAL);
36.         for (String s : list) {
37.             numberingBuilder.addItem(s);
38.         }
39.         dataMap.put("witness", numberingBuilder.create());
40.         //添加图片，考虑到实际生产环境图片大都都从文件服务获取，所以这里用图片流做例子
41.         PictureRenderData pictureRenderData = Pictures.ofStream(Files.newInputStream(Paths.get("D:\\picture\\其他\\24-05-23-142418.png")), PictureType.JPEG)
42.                 .size(300, 220).create();
43.         dataMap.put("image1", pictureRenderData);
44.         List<Qiankuan> qiankuanList = getQiankuanList();
45.         //添加表格
46.         //填充表头，表格的第一行
47.         RowRenderData row0 = Rows.of("拖欠物品", "拖欠次数", "偿还期限").center().bgColor("4472C4").create();
48.         Tables.TableBuilder tableBuilder = Tables.of(row0);
49.         //填充表格内容
50.         for (Qiankuan qiankuan : qiankuanList) {
51.             RowRenderData row = Rows.create(qiankuan.getName(), String.valueOf(qiankuan.getCount()), qiankuan.getQixian());
52.             tableBuilder.addRow(row);
53.         }
54.         //MergeCellRule rule = MergeCellRule.builder().map(MergeCellRule.Grid.of(1, 0), MergeCellRule.Grid.of(1, 2)).build();
55.         //tableBuilder.mergeRule(rule);
56.         dataMap.put("table1", tableBuilder.create());
58.         ChartMultiSeriesRenderData chart = Charts
59.                 .ofMultiSeries("ChartTitle", new String[] { "中文", "English" })
60.                 .addSeries("countries", new Double[] { 15.0, 6.0 })
61.                 .addSeries("speakers", new Double[] { 223.0, 119.0 })
62.                 .create();
64.         dataMap.put("barChart", chart);
65.         XWPFTemplate template = XWPFTemplate.compile(fileInputStream, builder.build())
66.                 .render(dataMap);
67.         template.writeAndClose(Files.newOutputStream(Paths.get("D:\\test\\qiantiao-poitl.docx")));
68.         System.out.println("success");
69.     }
71.     static List<Qiankuan> getQiankuanList() {
72.         List<Qiankuan> list = new ArrayList<>();
73.         Qiankuan q1 = new Qiankuan();
74.         q1.setName("一顿老魏");
75.         q1.setCount(1);
76.         q1.setQixian("三月内");
77.         list.add(q1);
79.         Qiankuan q2 = new Qiankuan();
80.         q2.setName("一顿大黄牛");
81.         q2.setCount(1);
82.         q2.setQixian("半年内");
83.         list.add(q2);
85.         Qiankuan q3 = new Qiankuan();
86.         q3.setName("特一特");
87.         q3.setCount(3);
88.         q3.setQixian("一周内");
89.         list.add(q3);
91.         Qiankuan q4 = new Qiankuan();
92.         q4.setName("v我50");
93.         q4.setCount(5);
94.         q4.setQixian("一周内");
95.         list.add(q4);
96.         return list;
97.     }
98.    
99. }

复制代码

3、生成效果



免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！