场景
若依管理系统前后端分离版基于ElementUI和SpringBoot怎样实现Excel导入和导出:
若依管理系统前后端分离版基于ElementUI和SpringBoot怎样实现Excel导入和导出_若依导出前端获得到后端的execl流之后怎么操作-CSDN博客
上面讲的是Excel的导出，如果是需要根据word文档的模板，比如根据数据库中数据或者其它数据源循环
根据模板填充数据，可填充文字、图片、表格、图表等数据。
poi-tl
poi-tl（poi template language）是Word模板引擎，使用Word模板和数据创建很棒的Word文档。
poi-tl是一款采用Apache License 2.0开源协议的开源产品
poi-tl的github地址：
GitHub - Sayi/poi-tl: Generate awesome word(docx) with template
poi-tl技术文档地址：
Poi-tl Documentation
为什么使用poi-tl
poi-tl模板引擎功能
| 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，也可以在指定位置进行合并 |
| 用户自定义函数(插件) | 插件化设计，在文档任何位置执行函数 |
注：
博客：
霸道流氓气质-CSDN博客
实现
1、快速开始
注意这里poi-tl与poi的对应关系
当前poi-tl的最新版本为1.12.2，需要对应poi的版本5.2.2+
如果poi不是用的该版本，则找对应版本的对应关系。
比如这里使用的poi版本为
<dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>4.1.2</version> </dependency>则需要引入对应的poi-tl的版本为1.8.2
<dependency> <groupId>com.deepoove</groupId> <artifactId>poi-tl</artifactId> <version>1.8.2</version> </dependency>相应的文档地址
Poi-tl Documentation
2、新建模板文件，以docx后缀结尾
并在模板文件中需要显示内容的位置，添加标签
{{title}}
文本标签测试
新建渲染方法
public static void render(Map<String, Object> map){ XWPFTemplate template = XWPFTemplate.compile("D://test//temp.docx").render(map); try { FileOutputStream out = new FileOutputStream("D://test//output.docx"); template.write(out); out.flush(); out.close(); template.close(); } catch (IOException e) { e.printStackTrace(); } }其中temp.docx是模板文件，oupput.docx是输出的文件
调用渲染方法
render(new HashMap<String, Object>(){{ put("title", "Hi, poi-tl Word模板引擎"); }});运行结果
3、文本标签复杂属性
数据模型
String ：文本
TextRenderData ：有样式的文本
HyperLinkTextRenderData ：超链接文本
Object ：调用 toString() 方法转化为文本
示例代码
HashMap<String, Object> data = new HashMap<>(); data.put("name", "Sayi"); data.put("start_time", "2019-08-04"); data.put("author", new TextRenderData("000000", "Sayi")); data.put("author2", new TextRenderData("霸道的程序猿", StyleBuilder.newBuilder() .buildColor("00FF00")//颜色 .buildStrike()//删除线 .buildBold()//粗体 .buildItalic()//斜体 .buildUnderLine()//下划线 .buildFontFamily("微软雅黑")//字体 .buildFontSize(12)//字号 .build() )); // 超链接 data.put("link", new HyperLinkTextRenderData("website", "卅一")); // 锚点 data.put("anchor", new HyperLinkTextRenderData("anchortxt", "anchor:appendix1")); render(data);运行效果
4、图片标签
图片标签以@开始：{{@var}}
示例代码
HashMap<String, Object> data = new HashMap<>(); // 本地图片 data.put("local", new PictureRenderData(80, 100, "D://test//test.png")); // 图片流 try { data.put("localbyte", new PictureRenderData(80, 100, ".png", new FileInputStream("D://test//test.png"))); } catch (FileNotFoundException e) { e.printStackTrace(); } // 网络图片(注意网络耗时对系统可能的性能影响) data.put("urlpicture", new PictureRenderData(50, 50, ".png", BytePictureUtils.getUrlBufferedImage("http://deepoove.com/images/icecream.png"))); // java 图片 try { BufferedImage image = ImageIO.read(new File("D://test//test.png")); data.put("bufferimage", new PictureRenderData(80, 100, ".png", image)); } catch (IOException e) { e.printStackTrace(); } render(data);运行结果
5、表格标签
表格标签以#开始：{{#var}}
示例代码
HashMap<String, Object> data = new HashMap<>(); RowRenderData header = RowRenderData.build(new TextRenderData("000000", "姓名"), new TextRenderData("000000", "学历")); RowRenderData row0 = RowRenderData.build("张三", "研究生"); RowRenderData row1 = RowRenderData.build("李四", "博士"); data.put("table", new MiniTableRenderData(header, Arrays.asList(row0, row1))); render(data);运行结果
6、图表标签-饼状图
模板文件中插入图表-饼状图
右击饼图，查看可选文字-输入
{{pieChart}}
编写测试代码
HashMap<String, Object> data = new HashMap<>(); ChartSingleSeriesRenderData pie = new ChartSingleSeriesRenderData(); pie.setChartTitle("ChartTitle"); pie.setCategories(new String[] { "俄罗斯", "加拿大", "美国", "中国" }); pie.setSeriesData(new SeriesRenderData("countries", new Integer[] { 17098242, 9984670, 9826675, 9596961 })); data.put("pieChart", pie); render(data);运行结果
其它图表使用参考官网。
7、pot-tl还有更多的功能、模板、示例代码可参考官网
