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));
}
最后
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数初中级Android工程师,想要提升技能,往往是自己摸索成长,自己不成体系的自学效果低效漫长且无助。
因此我收集整理了一份《2024年Android移动开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点!不论你是刚入门Android开发的新手,还是希望在技术上不断提升的资深开发者,这些资料都将为你打开新的学习之门
如果你觉得这些内容对你有帮助,需要这份全套学习资料的朋友可以戳我获取!!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
44531837)]
[外链图片转存中…(img-Lz56vkoD-1715744531838)]
[外链图片转存中…(img-58skamUe-1715744531840)]
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Android开发知识点!不论你是刚入门Android开发的新手,还是希望在技术上不断提升的资深开发者,这些资料都将为你打开新的学习之门
如果你觉得这些内容对你有帮助,需要这份全套学习资料的朋友可以戳我获取!!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!