poi-tl(好用到爆的word模板引擎)
发布网友
发布时间：6分钟前
共1个回答
热心网友
时间：2分钟前
1、poi-tl是什么
poi-tl是一个基于Apache POI的Word模板引擎，同时它也是一个免费开源（github地址）的Java类库，给Java程序员带来了word处理上的便捷。
2、官方介绍在文档的任何地方做任何事情（Do Anything Anywhere）是poi-tl的星辰大海。
2.1 poi-tl与其他word模板引擎的对比
方案移植性功能性易用性Poi-tlJava跨平台Word模板引擎基于Apache POI，更友好的APIApache POIJava跨平台Apache项目，不仅封装了易用的文档API(文本、图片、表格、页眉、页脚、图表等)，也可以在底层直接操作XML结构文档不全，这里有一个教程：Apache POI Word快速入门FreemarkerXML跨平台仅支持文本，很大的局限性不推荐，需要维护XML结构，代码后期不可维护OpenOffice部署OpenOffice，移植性较差-需要了解OpenOffice的APIHTML浏览器导出依赖浏览器的实现，移植性较差HTML不能很好的兼容Word的格式-Jacob、winlibWindows平台-复杂，完全不推荐使用2.2 poi-tl的编码模式
TDO模式： Template + data-model = output
2.2.1 Template—模板
模板即Docx格式的Word文档
2.2.2 Data-model—数据
数据即模板中需要替换的数据结构，类似哈希或者字典，常用Map结构，其中key即需要替换的标签
2.2.3 Output—输出
输出即最终文档的流产生，可以是文件流或网络流等
3、软件要求Apache POI 4.1.2
jdk 1.8+
maven依赖
<dependency><groupId>com.deepoove</groupId><artifactId>poi-tl</artifactId><version>1.10.0</version></dependency>4、标签4.1 文本
标签
{{var}}
数据模型
String：文本
TextRenderData：有样式的文本
HyperlinkTextRenderData ：超链接和锚点文本
Object：调用 toString() 方法转化为文本
测试模板
测试代码
packagecom.lizba.poi;importcom.deepoove.poi.XWPFTemplate;importcom.deepoove.poi.data.Texts;importjava.io.FileOutputStream;importjava.io.IOException;importjava.util.HashMap;/***<p>*文本测试*</p>**@Author:Liziba*@Date:2021/6/2421:49*/publicclassDocTest{publicstaticvoidmain(String[]args)throwsIOException{StringfilePath="D:\poi-tl\textTest.docx";StringtargetPath="D:\poi-tl\textTestTarget.docx";XWPFTemplatetemplate=XWPFTemplate.compile(filePath).render(newHashMap<String,Object>(){{put("name","测试");put("author",Texts.of("Liziba").color("000000").create());put("link",Texts.of("百度").link("https://baidu.com").create());put("anchor",Texts.of("anchortxt").anchor("appendix1").create());}});template.writeAndClose(newFileOutputStream(targetPath));}}测试结果
4.2 图片
标签
{{@var}}
数据模型
String：图片url或者本地路径。默认使用图片自身尺寸
PictureRenderData
测试模板
测试代码
packagecom.lizba.poi;importcom.deepoove.poi.XWPFTemplate;importcom.deepoove.poi.data.PictureType;importcom.deepoove.poi.data.Pictures;importcom.deepoove.poi.data.Texts;importjava.io.FileInputStream;importjava.io.FileOutputStream;importjava.io.IOException;importjava.util.HashMap;/***<p>*图片测试*</p>**@Author:Liziba*@Date:2021/6/2421:49*/publicclassPictureTest{publicstaticvoidmain(String[]args)throwsIOException{StringfilePath="D:\poi-tl\pictureTest.docx";StringtargetPath="D:\poi-tl\pictureTest2.docx";StringpicPath="D:\poi-tl\pic.jpg";XWPFTemplatetemplate=XWPFTemplate.compile(filePath).render(newHashMap<String,Object>(){{//方法一、图片路径（原大小）put("picture",picPath);//方法二、指定图片大小put("picture",Pictures.ofLocal(picPath).size(420,350).center().create());//方法三、图片流put("picture",Pictures.ofStream(newFileInputStream(picPath),PictureType.JPEG).size(420,350).create());//针对网络图片、SVG图片、Java图片都有处理}});template.writeAndClose(newFileOutputStream(targetPath));}}测试结果
4.3 表格
标签
{{#var}}
数据模型
TableRenderData
测试模板
测试代码
packagecom.lizba.poi;importcom.deepoove.poi.XWPFTemplate;importcom.deepoove.poi.data.*;importjava.io.FileOutputStream;importjava.io.IOException;importjava.util.HashMap;/***<p>*列表测试*</p>**@Author:Liziba*@Date:2021/6/2421:49*/publicclassTableTest{publicstaticvoidmain(String[]args)throwsIOException{StringfilePath="D:\poi-tl\tableTest.docx";StringtargetPath="D:\poi-tl\tableTest2.docx";//表头RowRenderDatatableHead=Rows.of("姓名","性别","地址","微信公众号").center().bgColor("4472c4").create();//第一行RowRenderDatarow1=Rows.create("张三","男","广东深圳","liziba_98");//第二行RowRenderDatarow2=Rows.create("李四","男","广东深圳","liziba_98");//合并第一行和第二行的第二列与第三列MergeCellRulerule=MergeCellRule.builder().map(MergeCellRule.Grid.of(1,1),MergeCellRule.Grid.of(2,1)).map(MergeCellRule.Grid.of(1,2),MergeCellRule.Grid.of(2,2)).build();XWPFTemplatetemplate=XWPFTemplate.compile(filePath).render(newHashMap<String,Object>(){{put("table",Tables.of(tableHead,row1,row2).mergeRule(rule).center().create());}});template.writeAndClose(newFileOutputStream(targetPath));}}测试结果
4.4 列表、区块对、嵌套
....省略
5、总结
开发过程中，我们为了效率和可用性，都不大会考虑重复造轮子，在有成熟工具的时候选择一个合适的工具是一件事半功倍的事情，以上讲述了poi-tl的部分简单功能，看了上述编码方式也是仁者见仁智者见智吧，作者是非常喜欢通过poi-tl来处理word文档。具体其他特性读者可以去poi-tl的官网学习。
官网地址：http://deepoove.com/poi-tl
github地址：https://github.com/Sayi/poi-tl
热心网友
时间：7分钟前
1、poi-tl是什么
poi-tl是一个基于Apache POI的Word模板引擎，同时它也是一个免费开源（github地址）的Java类库，给Java程序员带来了word处理上的便捷。
2、官方介绍在文档的任何地方做任何事情（Do Anything Anywhere）是poi-tl的星辰大海。
2.1 poi-tl与其他word模板引擎的对比
方案移植性功能性易用性Poi-tlJava跨平台Word模板引擎基于Apache POI，更友好的APIApache POIJava跨平台Apache项目，不仅封装了易用的文档API(文本、图片、表格、页眉、页脚、图表等)，也可以在底层直接操作XML结构文档不全，这里有一个教程：Apache POI Word快速入门FreemarkerXML跨平台仅支持文本，很大的局限性不推荐，需要维护XML结构，代码后期不可维护OpenOffice部署OpenOffice，移植性较差-需要了解OpenOffice的APIHTML浏览器导出依赖浏览器的实现，移植性较差HTML不能很好的兼容Word的格式-Jacob、winlibWindows平台-复杂，完全不推荐使用2.2 poi-tl的编码模式
TDO模式： Template + data-model = output
2.2.1 Template—模板
模板即Docx格式的Word文档
2.2.2 Data-model—数据
数据即模板中需要替换的数据结构，类似哈希或者字典，常用Map结构，其中key即需要替换的标签
2.2.3 Output—输出
输出即最终文档的流产生，可以是文件流或网络流等
3、软件要求Apache POI 4.1.2
jdk 1.8+
maven依赖
<dependency><groupId>com.deepoove</groupId><artifactId>poi-tl</artifactId><version>1.10.0</version></dependency>4、标签4.1 文本
标签
{{var}}
数据模型
String：文本
TextRenderData：有样式的文本
HyperlinkTextRenderData ：超链接和锚点文本
Object：调用 toString() 方法转化为文本
测试模板
测试代码
packagecom.lizba.poi;importcom.deepoove.poi.XWPFTemplate;importcom.deepoove.poi.data.Texts;importjava.io.FileOutputStream;importjava.io.IOException;importjava.util.HashMap;/***<p>*文本测试*</p>**@Author:Liziba*@Date:2021/6/2421:49*/publicclassDocTest{publicstaticvoidmain(String[]args)throwsIOException{StringfilePath="D:\poi-tl\textTest.docx";StringtargetPath="D:\poi-tl\textTestTarget.docx";XWPFTemplatetemplate=XWPFTemplate.compile(filePath).render(newHashMap<String,Object>(){{put("name","测试");put("author",Texts.of("Liziba").color("000000").create());put("link",Texts.of("百度").link("https://baidu.com").create());put("anchor",Texts.of("anchortxt").anchor("appendix1").create());}});template.writeAndClose(newFileOutputStream(targetPath));}}测试结果
4.2 图片
标签
{{@var}}
数据模型
String：图片url或者本地路径。默认使用图片自身尺寸
PictureRenderData
测试模板
测试代码
packagecom.lizba.poi;importcom.deepoove.poi.XWPFTemplate;importcom.deepoove.poi.data.PictureType;importcom.deepoove.poi.data.Pictures;importcom.deepoove.poi.data.Texts;importjava.io.FileInputStream;importjava.io.FileOutputStream;importjava.io.IOException;importjava.util.HashMap;/***<p>*图片测试*</p>**@Author:Liziba*@Date:2021/6/2421:49*/publicclassPictureTest{publicstaticvoidmain(String[]args)throwsIOException{StringfilePath="D:\poi-tl\pictureTest.docx";StringtargetPath="D:\poi-tl\pictureTest2.docx";StringpicPath="D:\poi-tl\pic.jpg";XWPFTemplatetemplate=XWPFTemplate.compile(filePath).render(newHashMap<String,Object>(){{//方法一、图片路径（原大小）put("picture",picPath);//方法二、指定图片大小put("picture",Pictures.ofLocal(picPath).size(420,350).center().create());//方法三、图片流put("picture",Pictures.ofStream(newFileInputStream(picPath),PictureType.JPEG).size(420,350).create());//针对网络图片、SVG图片、Java图片都有处理}});template.writeAndClose(newFileOutputStream(targetPath));}}测试结果
4.3 表格
标签
{{#var}}
数据模型
TableRenderData
测试模板
测试代码
packagecom.lizba.poi;importcom.deepoove.poi.XWPFTemplate;importcom.deepoove.poi.data.*;importjava.io.FileOutputStream;importjava.io.IOException;importjava.util.HashMap;/***<p>*列表测试*</p>**@Author:Liziba*@Date:2021/6/2421:49*/publicclassTableTest{publicstaticvoidmain(String[]args)throwsIOException{StringfilePath="D:\poi-tl\tableTest.docx";StringtargetPath="D:\poi-tl\tableTest2.docx";//表头RowRenderDatatableHead=Rows.of("姓名","性别","地址","微信公众号").center().bgColor("4472c4").create();//第一行RowRenderDatarow1=Rows.create("张三","男","广东深圳","liziba_98");//第二行RowRenderDatarow2=Rows.create("李四","男","广东深圳","liziba_98");//合并第一行和第二行的第二列与第三列MergeCellRulerule=MergeCellRule.builder().map(MergeCellRule.Grid.of(1,1),MergeCellRule.Grid.of(2,1)).map(MergeCellRule.Grid.of(1,2),MergeCellRule.Grid.of(2,2)).build();XWPFTemplatetemplate=XWPFTemplate.compile(filePath).render(newHashMap<String,Object>(){{put("table",Tables.of(tableHead,row1,row2).mergeRule(rule).center().create());}});template.writeAndClose(newFileOutputStream(targetPath));}}测试结果
4.4 列表、区块对、嵌套
....省略
5、总结
开发过程中，我们为了效率和可用性，都不大会考虑重复造轮子，在有成熟工具的时候选择一个合适的工具是一件事半功倍的事情，以上讲述了poi-tl的部分简单功能，看了上述编码方式也是仁者见仁智者见智吧，作者是非常喜欢通过poi-tl来处理word文档。具体其他特性读者可以去poi-tl的官网学习。
官网地址：http://deepoove.com/poi-tl
github地址：https://github.com/Sayi/poi-tl
