- Java锁的逻辑(结合对象头和ObjectMonitor)
- 还在用饼状图?来瞧瞧这些炫酷的百分比可视化新图形(附代码实现)⛵
- 自动注册实体类到EntityFrameworkCore上下文,并适配ABP及ABPVNext
- 基于Sklearn机器学习代码实战
@ 。
poi-tl 是一个基于Apache POI的Word模板引擎,也是一个免费开源的Java类库。同类型的FreeMarker或Velocity基于文本模板和数据生成新的html页面或配置文件。而poi tl是一个基于Word模板和数据生成新文档的Word模板引擎.
Word模板具有丰富的样式。Poi-tl将在生成的文档中完美地保留模板中的样式。也可以设置标记的样式。标记的样式将应用于替换的文本,因此您可以专注于模板设计.
poi-tl是一个“无逻辑”模板引擎。没有复杂的控制结构和变量分配,只有标签,有些标签可以用文本、图片、表格等代替,有些标签会隐藏某些文档内容,而另一些标签会循环一系列文档内容.
像变量赋值或条件语句这样的“强大”构造可以很容易地在模板系统中专门修改应用程序的外观。。。然而,以分离为代价,将模板本身变成应用程序逻辑的一部分.
poi-tl支持自定义函数(插件),函数可以在Word模板的任何地方执行,在文档的任何地方做任何事情都是poi-tl的目标.
GitHub - Sayi/poi-tl: Generate awesome word(docx) with template 。
Poi-tl Documentation (deepoove.com) 。
Apache License 2.0 。
下面表格是官方文档中提供的与其他模板引擎的对比 。
方案 | 移植性 | 功能性 | 易用性 |
---|---|---|---|
Poi-tl | Java跨平台 | Word模板引擎,基于Apache POI,提供更友好的API | 低代码,准备文档模板和数据即可 |
Apache POI | Java跨平台 | Apache项目,封装了常见的文档操作,也可以操作底层XML结构 | 文档不全,这里有一个教程:Apache POI Word快速入门 |
Freemarker | XML跨平台 | 仅支持文本,很大的局限性 | 不推荐,XML结构的代码几乎无法维护 |
OpenOffice | 部署OpenOffice,移植性较差 | - | 需要了解OpenOffice的API |
HTML浏览器导出 | 依赖浏览器的实现,移植性较差 | HTML不能很好的兼容Word的格式,样式糟糕 | - |
Jacob、winlib | Windows平台 | - | 复杂,完全不推荐使用 |
Word模板引擎功能 | 描述 |
---|---|
文本 | 将标签渲染为文本 |
图片 | 将标签渲染为图片 |
表格 | 将标签渲染为表格 |
列表 | 将标签渲染为列表 |
图表 | 条形图(3D条形图)、柱形图(3D柱形图)、面积图(3D面积图)、折线图(3D折线图)、雷达图、饼图(3D饼图)、散点图等图表渲染 |
If Condition判断 | 根据条件隐藏或者显示某些文档内容(包括文本、段落、图片、表格、列表、图表等) |
Foreach Loop循环 | 根据集合循环某些文档内容(包括文本、段落、图片、表格、列表、图表等) |
Loop表格行 | 循环复制渲染表格的某一行 |
Loop表格列 | 循环复制渲染表格的某一列 |
Loop有序列表 | 支持有序列表的循环,同时支持多级列表 |
Highlight代码高亮 | word中代码块高亮展示,支持26种语言和上百种着色样式 |
Markdown | 将Markdown渲染为word文档 |
Word批注 | 完整的批注功能,创建批注、修改批注等 |
Word附件 | Word中插入附件 |
SDT内容控件 | 内容控件内标签支持 |
Textbox文本框 | 文本框内标签支持 |
图片替换 | 将原有图片替换成另一张图片 |
书签、锚点、超链接 | 支持设置书签,文档内锚点和超链接功能 |
Expression Language | 完全支持SpringEL表达式,可以扩展更多的表达式:OGNL, MVEL… |
样式 | 模板即样式,同时代码也可以设置样式 |
模板嵌套 | 模板包含子模板,子模板再包含子模板 |
合并 | Word合并Merge,也可以在指定位置进行合并 |
用户自定义函数(插件) | 插件化设计,在文档任何位置执行函数 |
<dependency>
<groupId>com.deepoove</groupId>
<artifactId>poi-tl</artifactId>
<version>1.12.1</version>
</dependency>
implementation 'com.deepoove:poi-tl:1.12.1'
ConfigureBuilder builder = Configure.builder();
poi-tl所有的标签都是以 {{ 开头,以 }} 结尾,这是为了致敬Google CTemplate。标签可以出现在任何位置,包括页眉,页脚,表格内部,文本框等,表格布局可以设计出很多优秀专业的文档,推荐使用表格布局.
当然如果你更偏爱freemarker ${} 的方式,也可以添加如下配置修改标签的前后缀配置:
builder.buildGramer("${", "}");
XWPFTemplate template = XWPFTemplate.compile("template.docx", builder.buid());
poi-tl加载使用XWPFTemplate.compile方法来加载模板,支持模板以绝对路径(String),File、InputStream、XWPFDocument四种格式传入.
poi-tl数据类似于哈希或者字典,可以是Map结构(key是标签名称):
Map<String, Object> data = new HashMap<>();
data.put("name", "Sayi");
data.put("start_time", "2019-08-04");
template.render(dataMap);
poi-tl以流的方式进行输出:
template.write(OutputStream stream);
可以写到任意输出流中,比如文件流:
template.write(new FileOutputStream("output.docx"));
如网络流:
response.setContentType("application/octet-stream");
response.setHeader("Content-disposition","attachment;filename=\""+"out_template.docx"+"\"");
// HttpServletResponse response
OutputStream out = response.getOutputStream();
BufferedOutputStream bos = new BufferedOutputStream(out);
template.write(bos);
bos.flush();
out.flush();
PoitlIOUtils.closeQuietlyMulti(template, bos, out);
{{var}}
String :文本 。
TextRenderData :有样式的文本 。
HyperlinkTextRenderData :超链接和锚点文本 。
Object :调用 toString() 方法转化为文本 。
代码示例 。
put("name", "Sayi");
put("author", new TextRenderData("000000", "Sayi"));
put("link", new HyperlinkTextRenderData("website", "http://deepoove.com"));
put("anchor", new HyperlinkTextRenderData("anchortxt", "anchor:appendix1"));
除了new操作符,还提供了更加优雅的工厂 Texts 和链式调用的方式轻松构建文本模型.
链式代码示例 。
put("author", Texts.of("Sayi").color("000000").create());
put("link", Texts.of("website").link("http://deepoove.com").create());
put("anchor", Texts.of("anchortxt").anchor("appendix1").create());
图片标签以@开始:{{@var}}
String :图片url或者本地路径,默认使用图片自身尺寸 。
PictureRenderData 。
ByteArrayPictureRenderData 。
FilePictureRenderData 。
UrlPictureRenderData 。
// 指定图片路径
put("image", "logo.png");
// svg图片
put("svg", "https://img.shields.io/badge/jdk-1.6%2B-orange.svg");
// 设置图片宽高
put("image1", Pictures.ofLocal("logo.png").size(120, 120).create());
// 图片流
put("streamImg", Pictures.ofStream(new FileInputStream("logo.jpeg"), PictureType.JPEG)
.size(100, 120).create());
// 网络图片(注意网络耗时对系统可能的性能影响)
put("urlImg", Pictures.ofUrl("http://deepoove.com/images/icecream.png")
.size(100, 100).create());
// java图片
put("buffered", Pictures.ofBufferedImage(bufferImage, PictureType.PNG)
.size(100, 100).create());
表格标签以#开始:{{#var}}
TableRenderData
// 一个2行2列的表格
put("table0", Tables.of(new String[][] {
new String[] { "00", "01" },
new String[] { "10", "11" }
}).border(BorderStyle.DEFAULT).create());
// 第0行居中且背景为蓝色的表格
RowRenderData row0 = Rows.of("姓名", "学历").textColor("FFFFFF")
.bgColor("4472C4").center().create();
RowRenderData row1 = Rows.create("李四", "博士");
put("table1", Tables.create(row0, row1));
// 合并第1行所有单元格的表格
RowRenderData row0 = Rows.of("列0", "列1", "列2").center().bgColor("4472C4").create();
RowRenderData row1 = Rows.create("没有数据", null, null);
MergeCellRule rule = MergeCellRule.builder().map(Grid.of(1, 0), Grid.of(1, 2)).build();
put("table3", Tables.of(row0, row1).mergeRule(rule).create());
列表标签以*开始:{{*var}}
List<String>
NumberingRenderData
put("list", Numberings.create("Plug-in grammar",
"Supports word text, pictures, table...",
"Not just templates"));
首先我们建立一个word文件,在word文件里填充一下内容.
import com.deepoove.poi.XWPFTemplate;
import com.deepoove.poi.config.Configure;
import com.deepoove.poi.config.ConfigureBuilder;
import com.deepoove.poi.data.*;
import dto.Qiankuan;
import java.io.FileInputStream;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.time.LocalDate;
import java.util.*;
public class PoitlTest {
public static void main(String[] args) throws IOException {
ConfigureBuilder builder = Configure.builder();
//获取模板的文件流
FileInputStream fileInputStream = new FileInputStream("D:\\文章\\word生成\\poi-tl\\qiantiao.docx");
HashMap<String, Object> dataMap = new HashMap<>();
//添加文本
LocalDate currentDate = LocalDate.now();
LocalDate endDate = currentDate.plusYears(1L);
dataMap.put("debtor", "陈有楚");
dataMap.put("nowYear", String.valueOf(currentDate.getYear()));
dataMap.put("nowMonth", String.valueOf(currentDate.getMonthValue()));
dataMap.put("nowDay", String.valueOf(currentDate.getDayOfMonth()));
//验证换行的情况
dataMap.put("arrears", "\n一顿老魏,\n贵州大黄牛,\nv我50");
dataMap.put("endYear", String.valueOf(endDate.getYear()));
dataMap.put("endMonth", String.valueOf(endDate.getMonthValue()));
dataMap.put("endDay", String.valueOf(endDate.getDayOfMonth()));
//添加列表
List<String> list = Arrays.asList("阿大", "阿二", "阿三");
Numberings.NumberingBuilder numberingBuilder = Numberings.of(NumberingFormat.DECIMAL);
for (String s : list) {
numberingBuilder.addItem(s);
}
dataMap.put("witness", numberingBuilder.create());
//添加图片,考虑到实际生产环境图片大都都从文件服务获取,所以这里用图片流做例子
PictureRenderData pictureRenderData = Pictures.ofStream(Files.newInputStream(Paths.get("D:\\picture\\其他\\24-05-23-142418.png")), PictureType.JPEG)
.size(300, 220).create();
dataMap.put("image1", pictureRenderData);
List<Qiankuan> qiankuanList = getQiankuanList();
//添加表格
//填充表头,表格的第一行
RowRenderData row0 = Rows.of("拖欠物品", "拖欠次数", "偿还期限").center().bgColor("4472C4").create();
Tables.TableBuilder tableBuilder = Tables.of(row0);
//填充表格内容
for (Qiankuan qiankuan : qiankuanList) {
RowRenderData row = Rows.create(qiankuan.getName(), String.valueOf(qiankuan.getCount()), qiankuan.getQixian());
tableBuilder.addRow(row);
}
//MergeCellRule rule = MergeCellRule.builder().map(MergeCellRule.Grid.of(1, 0), MergeCellRule.Grid.of(1, 2)).build();
//tableBuilder.mergeRule(rule);
dataMap.put("table1", tableBuilder.create());
ChartMultiSeriesRenderData chart = Charts
.ofMultiSeries("ChartTitle", new String[] { "中文", "English" })
.addSeries("countries", new Double[] { 15.0, 6.0 })
.addSeries("speakers", new Double[] { 223.0, 119.0 })
.create();
dataMap.put("barChart", chart);
XWPFTemplate template = XWPFTemplate.compile(fileInputStream, builder.build())
.render(dataMap);
template.writeAndClose(Files.newOutputStream(Paths.get("D:\\test\\qiantiao-poitl.docx")));
System.out.println("success");
}
static List<Qiankuan> getQiankuanList() {
List<Qiankuan> list = new ArrayList<>();
Qiankuan q1 = new Qiankuan();
q1.setName("一顿老魏");
q1.setCount(1);
q1.setQixian("三月内");
list.add(q1);
Qiankuan q2 = new Qiankuan();
q2.setName("一顿大黄牛");
q2.setCount(1);
q2.setQixian("半年内");
list.add(q2);
Qiankuan q3 = new Qiankuan();
q3.setName("特一特");
q3.setCount(3);
q3.setQixian("一周内");
list.add(q3);
Qiankuan q4 = new Qiankuan();
q4.setName("v我50");
q4.setCount(5);
q4.setQixian("一周内");
list.add(q4);
return list;
}
}
最后此篇关于根据模板动态生成word(三)使用poi-tl生成word的文章就讲到这里了,如果你想了解更多关于根据模板动态生成word(三)使用poi-tl生成word的内容请搜索CFSDN的文章或继续浏览相关文章,希望大家以后支持我的博客! 。
更新:在做了更多测试后,现在更多的是文档。。TL;DR使用POSIX_FADV_DONTNEED是不值得的。不使用它可以获得最快的速度。在AMD64上,它甚至似乎没有得到尊重。。支持ext4文件系统的
TP-Link TL-WR847N路由器设置好连不上网怎么办?最近一位用户反馈说,自己的路由器型号是TP-Link TL-WR847N,按照说明书设置好路由器之后,发现连不上网,这是怎么回事呢?下面
TP-Link TL-WR880N路由器管理员默认密码是多少?对于TP-Link TL-WR880N路由器,有V1、V2、V3共3个硬件版本,不同的硬件版本,默认密码是不同的。下面就给大家分享TP-
它的作用:我有一段代码在单元格中找到一个子字符串 TL,并通过在“TL-”之后添加或删除 0 来强制其后面的数字长度为 6。 (即TL-00072 -> TL-000072、TL-034 -> TL-
我正在尝试让 s.tl() 传递 eVar,但调用在没有传递 eVar 的情况下触发,我无法弄清楚为什么,我通过同一页面上的另一个加载规则使用了相同的代码作品。 工作代码 setTimeout(
当发生碰撞时,我在游戏中反转 vector 时遇到了一些问题,我需要做的是每次弹珠撞击物体时将值翻转为当前值的倒数。 vector 是我需要反转的方向,以使反弹看起来逼真。 最佳答案 所以你说的是数学
我想知道我的 boundRect[].tl() 输出的单位是什么。 topleft = boundRect[largest_contour_index].tl(); 我的假设是以像素为单位。如果是这样
我正在从 github 下载 rtl8188eu-master 文件以在 debian 上安装此驱动程序。提取它并运行 make 命令后出现此错误。 make ARCH=i386 CROSS_COMP
我正在为我的最新项目使用 AngularJS。在文档和教程中,所有模型数据都放入 Controller 范围内。我知道它必须存在于 Controller 中,因此在相应的 View 中。 但是我认为该
这是我的类(class),用于以正确的方式显示土耳其里拉金额,我的类(class)没有设置输入的金额,例如,如果我输入 1200,它应该是 1,200 里拉,我会错过这里的步骤吗?我应该添加 Acti
我们刚刚添加了 SuperTag访问网站并观察到一个事件突然没有填充 s.events 值。 此代码在单击按钮时执行。 var s = s_gi(s_account); s.linkTrackVars
我无法通过SSH / Telnet连接到TP-Link TL-MR3220路由器。我已经转发了端口22和23,并尝试使用Microsoft Telnet和PuTTY,但是它不起作用。请帮忙。 最佳答案
我正在使用 tl 语言编译器来编译 https://core.telegram.org/mtproto 中描述的 Telegram Api TL 语言模式在 C# 中 有一个编译器可以将 tl 语言编
正如标题所示,我试图在我的加密狗上设置固定的比特率。我使用的是 TP-Link wifi 适配器型号 TL-WN722N。然而,当我给出命令: iwconfig wlanX 速率 2M 固定 iget
威尔 Omniture s.tl()函数算作一次额外的“访问”,因此导致该访问者不反弹? 最佳答案 它不会算作额外的“访问”,但会算作额外的“命中”。 包含多次点击的访问(在这种情况下,是 s.t()
我有一个 USB wifi 适配器 (TPLINK TL-WN822N。我从制造商那里下载了 linux 驱动程序 download page 并尝试编译它,但是当我尝试运行 make 命令时总是出错
我正在为 Site Catalyst 使用omnature jasavscript。 其中,我填充了链接单击所需的变量。 但问题是我只需单击一次即可获得多 (2) 次跟踪,这不是理想的行为。在这两个跟
我正在尝试按照 these instructions 使用 Knight Laboratories 的 Timeline JS 工具的本地实现。 。因为我的用例需要在 R 或 Python 中动态开发
我写了一个 tl 解析器,所以现在可以使用最新的层 (53)。但我不确定如何处理“标志”类型。它们仅在 tl 文档中提及,但未在此处页面底部定义(据我所知):link . 例如,当方法返回“消息”类型
我刚刚从 AppStore 更新到 Xcode 12.0.1 打开了我的旧项目,构建后出现错误。 这是错误的图像: 当我研究 SO 以寻求解决方案时,一些回答提到了在build设置中更改架构和更改仅构
我是一名优秀的程序员,十分优秀!