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}}
数据模型
-
String:文本
-
TextRenderData:有样式的文本
-
HyperlinkTextRenderData :超链接和锚点文本
-
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}}
数据模型
-
String:图片url或者本地路径。默认使用图片自身尺寸
-
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-TWreBR5o-1715336623690)]
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!