poi-tl—一个超级好用开源的Word模板引擎

poi-tl是一个基于Apache POI的Word模板引擎，同时它也是一个免费开源（github地址）的Java类库，给Java程序员带来了word处理上的便捷。

2、官方介绍

在文档的任何地方做任何事情（Do Anything Anywhere）是poi-tl的星辰大海。

​

2.1 poi-tl与其他word模板引擎的对比

| 方案 | 移植性 | 功能性 | 易用性 |

| — | — | — | — |

| Poi-tl | Java跨平台 | Word模板引擎 | 基于Apache POI，更友好的API |

| Apache POI | Java跨平台 | Apache项目，不仅封装了易用的文档API(文本、图片、表格、页眉、页脚、图表等)，也可以在底层直接操作XML结构 | 文档不全，这里有一个教程：Apache POI Word快速入门 |

| Freemarker | XML跨平台 | 仅支持文本，很大的局限性 | 不推荐，需要维护XML结构，代码后期不可维护 |

| OpenOffice | 部署OpenOffice，移植性较差 | - | 需要了解OpenOffice的API |

| HTML浏览器导出 | 依赖浏览器的实现，移植性较差 | HTML不能很好的兼容Word的格式 | - |

| Jacob、winlib | Windows平台 | - | 复杂，完全不推荐使用 |

​

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依赖

com.deepoove

poi-tl

1.10.0

4、标签

4.1 文本

标签

{{var}}

数据模型

1. String：文本

2. TextRenderData：有样式的文本

3. HyperlinkTextRenderData ：超链接和锚点文本

4. Object：调用 toString() 方法转化为文本

测试模板

测试代码

package com.lizba.poi;

import com.deepoove.poi.XWPFTemplate;

import com.deepoove.poi.data.Texts;

import java.io.FileOutputStream;

import java.io.IOException;

import java.util.HashMap;

/**

•   文本测试
  

• @Author: Liziba

• @Date: 2021/6/24 21:49

*/

public class DocTest {

public static void main(String[] args) throws IOException {

String filePath = “D:\poi-tl\textTest.docx”;

String targetPath = “D:\poi-tl\textTestTarget.docx”;

XWPFTemplate template = XWPFTemplate.compile(filePath).render(

new HashMap<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(new FileOutputStream(targetPath));

}

}

测试结果

4.2 图片

​

标签

{{@var}}

​

数据模型

1. String：图片url或者本地路径。默认使用图片自身尺寸

2. PictureRenderData

测试模板

测试代码

package com.lizba.poi;

import com.deepoove.poi.XWPFTemplate;

import com.deepoove.poi.data.PictureType;

import com.deepoove.poi.data.Pictures;

import com.deepoove.poi.data.Texts;

import java.io.FileInputStream;

import java.io.FileOutputStream;

import java.io.IOException;

import java.util.HashMap;

/**

•   图片测试
  

• @Author: Liziba

• @Date: 2021/6/24 21:49

*/

public class PictureTest {

public static void main(String[] args) throws IOException {

String filePath = “D:\poi-tl\pictureTest.docx”;

String targetPath = “D:\poi-tl\pictureTest2.docx”;

String picPath = “D:\poi-tl\pic.jpg”;

XWPFTemplate template = XWPFTemplate.compile(filePath).render(

new HashMap<String, Object>() {

{

// 方法一、图片路径（原大小）

put(“picture”, picPath);

// 方法二、指定图片大小

put(“picture”, Pictures.ofLocal(picPath).size(420,350).center().create());

// 方法三、图片流

put(“picture”, Pictures.ofStream(new FileInputStream(picPath), PictureType.JPEG)

.size(420,350).create());

// 针对网络图片、SVG图片、Java图片都有处理

}

});

template.writeAndClose(new FileOutputStream(targetPath));

}

最后

在这里我和身边一些朋友特意整理了一份快速进阶为Android高级工程师的系统且全面的学习资料。涵盖了Android初级——Android高级架构师进阶必备的一些学习技能。

附上：我们之前因为秋招收集的二十套一二线互联网公司Android面试真题（含BAT、小米、华为、美团、滴滴）和我自己整理Android复习笔记（包含Android基础知识点、Android扩展知识点、Android源码解析、设计模式汇总、Gradle知识点、常见算法题汇总。）

《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》，点击传送门，即可获取！
这里我和身边一些朋友特意整理了一份快速进阶为Android高级工程师的系统且全面的学习资料。涵盖了Android初级——Android高级架构师进阶必备的一些学习技能。**

附上：我们之前因为秋招收集的二十套一二线互联网公司Android面试真题（含BAT、小米、华为、美团、滴滴）和我自己整理Android复习笔记（包含Android基础知识点、Android扩展知识点、Android源码解析、设计模式汇总、Gradle知识点、常见算法题汇总。）

[外链图片转存中…(img-BIihKcxo-1715864047532)]

《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》，点击传送门，即可获取！