开源项目之word模板引擎

今天给大家推荐一款非常好用的开源word模板引擎，它的名字叫Poi-tl。

官方文档地址为:

http://deepoove.com/poi-tl/

Github源代码地址为:

https://github.com/Sayi/poi-tl

活跃情况:

一、Poi-tl是什么？

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

二、为什么要使用Poi-tl，它与Apache Poi、Freemarker、Open Office等有什么不同？

引用官网上面的一张图，足以解释:

三、怎样使用？

1.引入方式

Maven

<dependency>
  <groupId>com.deepoove</groupId>
  <artifactId>poi-tl</artifactId>
  <version>1.12.0</version>
</dependency>

Gradle

implementation 'com.deepoove:poi-tl:1.12.0'

核心使用代码:

XWPFTemplate template = XWPFTemplate.compile("template.docx").render(
  new HashMap<String, Object>(){{
    put("title", "Hi, YC");
}});  
template.writeAndClose(new FileOutputStream("output.docx"));

所注入的Word模板，可支持类型:

• 文本

• 图片

• 列表

• 区块对

• 嵌套

• 多系列图表

• 单系列图表

• 组合图表

官方文档均体现，这里不一一说明，如图所示:

四、应用场景

引用官方文档所示例，如下:

1.付款通知书

2.目标制定

3.证书

4.个人简历

我在去年的时候，曾用其做过报表相关生成，具体详情可阅读这篇文章:

基于报告之复盘

五、我所研发的分布式微服务框架YC-Framework也支持word模板引擎

官方文档网站:

http://framework.youcongtech.com/#/zh-cn/word

关于YC-Framework介绍，可阅读如下两篇文章:

我的分布式微服务框架:YC-Framework

从零开始学YC-Framework之初步

源代码示例:

https://github.com/developers-youcong/yc-framework/tree/main/yc-example/yc-example-poitl