poi-tl的使用

最新推荐文章于 2024-04-14 20:02:22 发布
最新推荐文章于 2024-04-14 20:02:22 发布
阅读量2.9w 收藏 125
点赞数 18
分类专栏： Excel和Docx的导出 文章标签： java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_41532872/article/details/108644773
版权

poi-tl（poi template language）是Word模板引擎，基于Microsoft Word模板和数据生成新的文档。

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

1.入门

1.添加依赖

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

2.定义模板
在这里插入图片描述
3.代码

import com.deepoove.poi.XWPFTemplate;

import java.io.FileOutputStream;
import java.io.IOException;
import java.util.*;

public class Test {

    public static void main(String[] args) throws IOException {
        Map<String, Object> data = new HashMap<>();
        data.put("name", "司天宏");
        data.put("start_time", "2020-09-17");
        XWPFTemplate template = XWPFTemplate.compile("F:/template.docx")
                .render(data);
        FileOutputStream out;
        out = new FileOutputStream("F:/template2.docx");
        template.write(out);
        out.flush();
        out.close();
        template.close();

    }

}

效果
在这里插入图片描述
4.数据也可以是对象

import com.deepoove.poi.XWPFTemplate;

import java.io.FileOutputStream;
import java.io.IOException;
import java.util.*;

public class Test {

    public static void main(String[] args) throws IOException {
        Map<String, Object> data = new HashMap<>();
        Sth sth = new Sth("司天宏", "武汉");
        data.put("sth",sth);
        XWPFTemplate template = XWPFTemplate.compile("F:/template.docx")
                .render(data);
        FileOutputStream out;
        out = new FileOutputStream("F:/template2.docx");
        template.write(out);
        out.flush();
        out.close();
        template.close();

    }

}

class Sth {
    private String name;
        private String addr;

    public Sth(String name, String addr) {
        this.name = name;
        this.addr = addr;
    }
}

template中这么取值
在这里插入图片描述
代码运行效果
在这里插入图片描述

二.标签

poi-tl是一种 “logic-less” 模板引擎，没有复杂的控制结构和变量赋值，只有标签。标签由前后两个大括号组成， {{title}} 是标签， {{?title}} 也是标签， title 是这个标签的名称， ? 标识了标签类型，接下来我们来看看有哪些默认标签类型(用户可以创建新的标签类型，这属于更高级的话题)。

2.1.文本

模板中这样写
在这里插入图片描述

数据模型：

String ：文本

TextRenderData ：有样式的文本

HyperLinkTextRenderData ：超链接文本

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

代码

  Map<String, Object> data = new HashMap<>();
        data.put("author", new TextRenderData("000000", "Sayi"));
// 超链接
        data.put("link",
                new HyperLinkTextRenderData("website", "http://deepoove.com"));
// 锚点
        data.put("anchor",
                new HyperLinkTextRenderData("anchortxt", "anchor:appendix1"));
        XWPFTemplate template = XWPFTemplate.compile("F:/template.docx")
                .render(data);
        FileOutputStream out;
        out = new FileOutputStream("F:/template2.docx");
        template.write(out);
        out.flush();
        out.close();
        template.close();

效果在这里插入图片描述

所见即所得，标签的样式会应用到替换后的文本上，也可以通过代码设定文本的样式。

TextRenderData 的结构体

{
  "text": "Sayi",
  "style": {
    "strike": false, 
    "bold": true, 
    "italic": false, 
    "color": "00FF00", 
    "underLine": false, 
    "fontFamily": "微软雅黑", 
    "fontSize": 12, 
    "highlightColor": "green", 
    "vertAlign": "superscript" 
  }
}
删除线
粗体
斜体
颜色
下划线
字体
字号
背景高亮色
上标或者下标
2.2.图片

图片标签以@开始：{{@var}}
模板示例 {{@local}}

代码

import com.deepoove.poi.XWPFTemplate;
import com.deepoove.poi.data.HyperLinkTextRenderData;
import com.deepoove.poi.data.PictureRenderData;
import com.deepoove.poi.data.TextRenderData;
import com.deepoove.poi.util.BytePictureUtils;

import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.*;

public class Test {

    public static void main(String[] args) throws IOException {
        Map<String, Object> data = new HashMap<>();
        // 本地图片
        data.put("local", new PictureRenderData(80, 100, "F:/图片.jpg"));

// 图片流
       // data.put("localbyte", new PictureRenderData(80, 100, ".png", new FileInputStream("./logo.png")));

// 网络图片(注意网络耗时对系统可能的性能影响)
       // data.put("urlpicture", new PictureRenderData(50, 50, ".png", BytePictureUtils.getUrlBufferedImage("http://deepoove.com/images/icecream.png")));

// java 图片
        //data.put("bufferimage", new PictureRenderData(80, 100, ".png", bufferImage)));
        XWPFTemplate template = XWPFTemplate.compile("F:/template.docx")
                .render(data);
        FileOutputStream out;
        out = new FileOutputStream("F:/template2.docx");
        template.write(out);
        out.flush();
        out.close();
        template.close();

    }

}

在这里插入图片描述
图片支持 BufferedImage，这意味着我们可以利用Java生成图表插入到word文档中。

PictureRenderData 的结构体

{
  "path": "", 
  "data": [], 
  "altMeta": "图片不存在", 
  "width": 100, 
  "height": 100 
}
图片路径
图片也可以是byte[]字节数组
当无法获取图片时展示的文字
宽度，单位是像素
高度，单位是像素
2.3.表格

表格标签以#开始：{{#var}}

poi-tl默认实现了N行N列的样式(如下图)，同时提供了当数据为空时，展示一行空数据的文案(如下图中的No Data Descs)，数据模型是 MiniTableRenderData 。

在这里插入图片描述

代码

import com.deepoove.poi.XWPFTemplate;
import com.deepoove.poi.data.*;

import java.io.FileOutputStream;
import java.io.IOException;
import java.util.*;

public class Test {

    public static void main(String[] args) throws IOException {
        Map<String, Object> data = new HashMap<>();
        RowRenderData header = RowRenderData.build(new TextRenderData("FF0000", "姓名"), new TextRenderData("FF0000", "学历"));

        RowRenderData row0 = RowRenderData.build("张三", "研究生");
        RowRenderData row1 = RowRenderData.build("李四", "博士");

        data.put("table", new MiniTableRenderData(header, Arrays.asList(row0, row1)));
        XWPFTemplate template = XWPFTemplate.compile("F:/template.docx")
                .render(data);
        FileOutputStream out;
        out = new FileOutputStream("F:/template2.docx");
        template.write(out);
        out.flush();
        out.close();
        template.close();

    }

}

效果展示
在这里插入图片描述

MiniTableRenderData 的结构体
{
  "rows": [ 
    {
      "cells": [ 
        {
          "cellText": [TextRenderData],
          "cellStyle": { 
            "align": "center",
            "backgroundColor": "ff9800"
          }
        }
      ],
      "rowStyle": { 
        "align": "center",
        "backgroundColor": "ff9800"
      }
    }
  ],
  "header": { 
    "cells": [
      {
        "cellText": [TextRenderData],
        "cellStyle": {
          "align": "center",
          "backgroundColor": "ff9800"
        }
      }
    ],
    "rowStyle": { 
      "align": "center",
      "backgroundColor": "ff9800"
    }
  },
  "noDatadesc": "No Data Desc", 
  "style": { 
      "align": "center"
    }
  "width": 14.65 
}
定义表格行数据
定义单元格数据，数据由 TextRenderData 指定
单元格样式：对齐方式，背景色
行样式：行数据的对齐方式，行背景色
定义表格头
没有数据的展示文案
表格样式：表格居左、居中、居右对齐
表格宽度(单位cm)，表格的最大宽度 = 页面宽度 - 页边距宽度 * 2，页面宽度为A4(20.99 * 29.6，页边距为3.17 * 2.54)的文档最大表格宽度14.65CM。
2.4.列表

列表标签以*开始：{{*var}}

代码

package com.sunwayworld.sunrui;


import com.deepoove.poi.XWPFTemplate;
import com.deepoove.poi.data.*;

import java.io.FileOutputStream;
import java.io.IOException;
import java.util.*;

public class Test {

    public static void main(String[] args) throws IOException {
        Map<String, Object> data = new HashMap<>();
        data.put("list", new NumbericRenderData(new ArrayList<TextRenderData>() {
            {
                add(new TextRenderData("这个是第一个列"));
                add(new TextRenderData("第二列"));
                add(new TextRenderData("这是第三列"));
            }
        }));
        XWPFTemplate template = XWPFTemplate.compile("F:/template.docx")
                .render(data);
        FileOutputStream out;
        out = new FileOutputStream("F:/template2.docx");
        template.write(out);
        out.flush();
        out.close();
        template.close();

    }

}

在这里插入图片描述

2.4.动态表格
import com.deepoove.poi.XWPFTemplate;
import com.deepoove.poi.config.Configure;
import com.deepoove.poi.policy.HackLoopTableRenderPolicy;

import java.util.*;

public class Test {
    public static void main(String[] args) throws Exception {
        List<Goods> goods = new ArrayList<>();
        Goods good = new Goods();
        good.setName("墙纸");
        good.setDesc("书房卧室");
        goods.add(good);
        goods.add(good);
        goods.add(good);
        goods.add(good);

        List<Labor> labors = new ArrayList<>();
        Labor labor = new Labor();
        labor.setCategory("油漆工");
        labor.setPeople(2);
        labors.add(labor);
        labors.add(labor);
        labors.add(labor);
        labors.add(labor);


        HackLoopTableRenderPolicy hackLoopTableRenderPolicy = new HackLoopTableRenderPolicy();
        Configure config = Configure.newBuilder().bind("goods", hackLoopTableRenderPolicy)
                .bind("labors", hackLoopTableRenderPolicy).build();
        XWPFTemplate template = XWPFTemplate.compile("F:/模板.docx",config).render(new HashMap<String, Object>() {
            {
                put("goods", goods);
                put("labors", labors);
            }
        });
        template.writeToFile("F:/啦啦啦.docx");
    }

    static class PaymentHackData {
        private List<Goods> goods;
        private List<Labor> labors;

        public List<Goods> getGoods() {
            return goods;
        }

        public void setGoods(List<Goods> goods) {
            this.goods = goods;
        }

        public List<Labor> getLabors() {
            return labors;
        }

        public void setLabors(List<Labor> labors) {
            this.labors = labors;
        }
    }

    static class Goods {
        private String name;
        private String desc;

        public String getName() {
            return name;
        }

        public void setName(String name) {
            this.name = name;
        }

        public String getDesc() {
            return desc;
        }

        public void setDesc(String desc) {
            this.desc = desc;
        }
    }

    static class Labor {
        private String category;
        private int people;

        public String getCategory() {
            return category;
        }

        public void setCategory(String category) {
            this.category = category;
        }

        public int getPeople() {
            return people;
        }

        public void setPeople(int people) {
            this.people = people;
        }
    }

}

效果展示
在这里插入图片描述
关键代码:在这里插入图片描述

3. 官方文档

poi-tl官方文档

司天宏
关注
  • 18
    点赞
  • 踩
  • 125
    收藏
    觉得还不错? 一键收藏
  • 16
    评论
专栏目录
poi-tl—一个超级好用开源的Word模板引擎
Java框架、并发编程、分布式、微服务、Redis、HarmonyOS、中间件等技术
06-24 2万+
1、poi-tl是什么 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 Apa
Java使用poi-tl生成word文档
02-23
Java使用poi-tl生成word文档
poi-tl-1.7.2.jar
04-23
java导出word，使用最新版poi-tl-1.7.2jar。
poi-tl：Java中以{{template}}模板化的最小word（docx）
02-03
poi-tl（poi-template-language） Word模板引擎，基于Apache POI-Microsoft文档的Java API。 什么是poi-tl FreeMarker，Velocity基于文本模板和数据生成新HTML页面，配置文件等，poi-tl是Word模板引擎，基于Microsoft Word模板和数据生成新的文档。 Word模板拥有丰富的样式，poi-tl在生成的文档中会完美保留模板中的样式，还可以为标签设置样式，标签的样式会被应用到替换后的文本上，因此您可以专注于模板设计。 poi-tl是一种“逻辑少”模板引擎，没有复杂的控制结构和变量赋值，只有标签，一些
poi-tl(word模板渲染)
一叶知春秋
09-25 1万+
pot-tl是一个word模板渲染引擎，支持图片、文本、表格等不同的模板数据渲染。
poi-tl的使用（最全详解）
热门推荐
JavaSupeMan的博客
07-07 3万+
官网地址poi-tl，简单的说，就是通过一些标记，如{{text}},{{@image}}等，放到你指定的word模板里，然后去读取替换这些值，再输出填充数据后的word，可以做生成报表的功能 注意apache.poi版本要对应 二、准备工作 在D盘，自己创建两个文件夹，一个是用来存储模板文件，另一个是用来存储生成的文件 我这里是在D盘 D:\data\template 存放模板 D:\data\word 存放生成的文件注意，{{}}是官方指定的格式，可以查看官网，当然也可以自定义，这个后面来讲
Java使用poi-tl1.9.1生成Word文档的几个小技巧
夜郎King的博客
07-18 1万+
本文将简单介绍poi-tl的相关知识，通过一个实际的案例实践，充分介绍如何利用poi-tl进行目标文档的生成，同时分享几个不同的office版本如何进行图表生成的解决方案
poi-tl-1.8.2.jar
12-23
为了更方便大家下载poi-tl-1.8.2.jar的Jar包
word源码java-poi-tl-plus:(Docx-MicrosoftWord模板流程)POI-TL(https://github.co
06-05
poi-tl-plus Enhancement to POI-TL (). Support defining Table templates directly in Microsoft Word (Docx) file. POI-TL的 MiniTableRenderData 可以支持简单的表格,但是表格样式和内容的样式无法在 Word 中...
poi-tl模板文件
02-08
POI-TL 模板文件有很多优点，例如易于使用、灵活性强、可重复使用等。通过使用 POI-TL 模板文件，可以快速生成业务目标制定报告，并且可以根据实际需要进行修改和调整。 结论 POI-TL 模板文件是一种功能强大且灵活...
poi-tl导出复杂word/pdf文档（去除aspose转pdf水印，多张图片、表格循环行合并列、表格带图片、循环多个模板导出，多个文档合并）
m0_49605579的博客
01-19 1万+
首先奉上poi-tl官方文档地址：http://deepoove.com/poi-tl/#_%E7%89%88%E6%9C%AC 1.导包 maven: <dependency> <groupId>com.deepoove</groupId> <artifactId>poi-tl</artifactId> <version>1.9.1</version> </dependency> gradle:
Word模板引擎poi-tl
骑个小蜗牛的博客
06-18 1万+
标签 1. 文本 2. 图片 3. 表格 4. 列表 5. 嵌套 6. 区块对 ◆ SpingEL 2. 单系列图标 3. 多系列图标 4. 组合图表 ◆ 配置 1. 标签前后缀 2. 标签类型 3. 标签匹配值 4. 标签值计算 5. SpringEL 6. 数据模型序列化 7. 错误处理 8. 模板生成模板 9. 无模板创建文档 10. 日志 ◆ 插件 1. 表格行循环 2. 表格列循环 3. 动态表格 4. 批注 5. 插入附件 6. 代码高亮 7. Markdown ◆ 自定义插件 - 定义插件
SpringBoot + Poi-tl操作word，快速生成报表
m0_71777195的博客
06-06 3068
poi-tl是一个免费开源的Java类库，是基于Apache POI的模板引擎，纯Java组件，跨平台，代码短小精悍，通过插件机制使其具有高度扩展性。因此在使用的时候需要实现设置好模板，就像Freemarker一样，但是比其简单，也易操作。
java 根据模板导出word文档(poi-tl)
qq_38860250的博客
03-14 7427
java 根据模板导出word文档(poi-tl)
java poi-tl word模板填充
Sam997的博客
02-07 2958
基于java poi-tl 的 word模板填充
poi-tl导出word
weixin_43580824的博客
03-15 2193
开发过程中，我们为了效率和可用性，都不大会考虑重复造轮子，在有成熟工具的时候选择一个合适的工具是一件事半功倍的事情，以上讲述了poi-tl的部分简单功能，看了上述编码方式也是仁者见仁智者见智吧，作者是非常喜欢通过poi-tl来处理word文档。Apache POI Java跨平台 Apache项目，不仅封装了易用的文档API(文本、图片、表格、页眉、页脚、图表等)，也可以在底层直接操作XML结构 文档不全，这里有一个教程：Apache POI Word快速入门。TextRenderData：有样式的文本。
poi-tl—一个超级好用开源的Word模板引擎，Java语言自学书籍
erthre的博客
03-21 1262
什么是ActiveMQ?ActiveMQ服务器宕机怎么办？丢消息怎么办？持久化消息非常慢怎么办？消息的不均匀消费怎么办？死信队列怎么办？ActiveMQ中的消息重发时间间隔和重发次数吗？
poi-tl的使用（通俗易懂，全面，内含动态表格实现 ！）
最新发布
smilehjl
04-14 3821
主要介绍了poi-tl的基本使用，以及poi-tl的动态表格的用法
poi-tl 使用TextRenderData字体大小
03-29
要在poi-tl中使用TextRenderData设置字体大小，可以设置TextRenderData的style属性。可以使用FontStyleBuilder来创建一个字体样式，然后将其设置为TextRenderData的style属性。以下是一个示例代码： ``` // 创建字体样式 FontStyleBuilder fontStyleBuilder = new FontStyleBuilder(); fontStyleBuilder.setFontSize(14); // 设置字体大小为14 FontStyle fontStyle = fontStyleBuilder.build(); // 创建TextRenderData TextRenderData textRenderData = new TextRenderData("Hello World", fontStyle); // 将TextRenderData添加到模板中 Map<String, Object> dataMap = new HashMap<>(); dataMap.put("text", textRenderData); // 使用模板生成文档 XWPFTemplate template = XWPFTemplate.compile("template.docx").render(dataMap); template.writeToFile("output.docx"); ``` 在上面的示例中，我们创建了一个字体样式，设置了字体大小为14。然后，我们使用这个样式创建了一个TextRenderData，并将其添加到模板中。最后，我们使用模板生成了一个新文档，并将其保存到磁盘上。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 16
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值