Poi-tl(Poi-template-language)

📝 Word 模板引擎，基于Apache POI进行了一些增强封装，如合并多个Word文档、合并单元格、图片处理等，插件机制使得可以基于模板引擎特性扩展出更丰富的功能。

模板和插件构建了整个Poi-tl的核心。

下表对一些处理Word的解决方案作了一些比较：

方案	跨平台	样式处理	易用性
Poi-tl	纯Java组件，跨平台	✅ 不需要编码，模板即样式	✅ 简单：模板引擎，对POI进行封装
Apache POI	纯Java组件，跨平台	编码	简单，没有模板引擎功能
Freemarker	XML操作，跨平台	无	复杂，需要理解XML结构，基于XML构造模板
OpenOffice	需要安装OpenOffice软件	编码	复杂，需要了解OpenOffice的API
Jacob、winlib	Windows平台	编码	复杂，不推荐使用

Maven

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

2分钟快速入门

从一个超级简单的例子开始：把{{title}}替换成"Poi-tl 模板引擎"。

新建文档template.docx，包含文本{{title}}
TDO模式：Template + data-model = output

//核心API采用了极简设计，只需要一行代码
XWPFTemplate template = XWPFTemplate.compile("~/template.docx").render(new HashMap<String, Object>(){{
        put("title", "Poi-tl 模板引擎");
}});
FileOutputStream out = new FileOutputStream("out_template.docx");
template.write(out);
out.flush();
out.close();
template.close();

详细文档与示例

中文文档 or English-tutorial Wiki

更多的示例以及所有示例的源码参见JUnit单元测试。

架构Arch

Poi-tl通过极简的架构实现了模板功能并且支持最大的扩展性，架包体积仅有几十KB。

整体设计采用了Template + data-model = output模式，Configure提供了模板配置功能，比如语法配置和插件配置，Visitor提供了模板解析功能，RenderPolicy是渲染策略扩展点，Render模块通过RenderPolicy对每个标签进行渲染。

建议和完善