很多小伙伴在工作中,可能又这样一个需求:根据word模板去填充数据,变成我们想要的word文档,这是很多刚进入职场的小白都会碰到的需求。
当遇上这种需求,我们可以通过这篇文章要讲的poi-tl 来做处理。
导入依赖
<dependency>
<groupId>com.deepoove</groupId>
<artifactId>poi-tl</artifactId>
<version>1.5.1</version>
</dependency>
填充文本
首先,我们需要先准备一个word文档,必须是.docx结尾的哦。
我们先在指定的位置创建一个测试文档。我这边直接在springboot中的templates目录下创建一个名为test1.docx的文件。
这里需要注意:对于文本数据而言,动态填充的数据,用{{}}包裹即可。
//掌握如何填充文本类型数据
@Test
void contextLoads() throws IOException {
String path="D:\\QQ_File\\1719036792\\FileRecv\\tuanfei\\src\\main\\resources\\templates\\test1.docx";
//第一步:读取模板
XWPFTemplate compile = XWPFTemplate.compile(path);
//第二步:创建数据,用于把我们模板中的{{}}包裹的变量替换掉,map中保存的key一定要和模板中的变量保持一致
HashMap<String, Object> map = new HashMap<>();
map.put("date", LocalDate.now());
compile.render(map);
//第三步:把设置的参数写入,并生成新的word文档
compile.writeToFile("D:\\QQ_File\\1719036792\\FileRecv\\tuanfei\\src\\main\\resources\\templates\\text.docx");
compile.close();
}
执行上面代码,会发现我们多了一个text.docx 的文档,打开看,发现数据已经被填充了。
填充图片
还是一样,我们创建一个用于填充数据的模板。不过对于文本而言,填充设置的参数需要用{{@}}来包含住。
我们先在指定的位置创建一个测试文档。我这边直接在springboot中的templates目录下创建一个名为imgTemplate.docx的文件。
imgTemplate文件打开是这样的:
当执行下面通过poi-tl实现的填充图片代码:
@Test
void test2() throws IOException {
String path="D:\\QQ_File\\1719036792\\FileRecv\\tuanfei\\src\\main\\resources\\templates\\imgTemplate.docx";
//第一步:读取模板
XWPFTemplate compile = XWPFTemplate.compile(path);
//第二步:创建数据,用于把我们模板中的{{}}包裹的变量替换掉,map中保存的key一定要和模板中的变量保持一致
HashMap<String, Object> map = new HashMap<>();
//本地图片
//120,120:代表设图片的长宽
map.put("img1",new PictureRenderData(120,120,"D:\\QQ_File\\1719036792\\FileRecv\\tuanfei\\src\\main\\resources\\templates\\img.png"));
//流图片
map.put("img2",new PictureRenderData(120,120,".png",new FileInputStream("D:\\QQ_File\\1719036792\\FileRecv\\tuanfei\\src\\main\\resources\\templates\\img.png")));
//网络图片
map.put("img3", new PictureRenderData(100, 100, ".jpg", BytePictureUtils.getUrlBufferedImage("https://gss0.baidu.com/-vo3dSag_xI4khGko9WTAnF6hhy/zhidao/pic/item/314e251f95cad1c8ba1e530c7d3e6709c93d5177.jpg")));
compile.render(map);
compile.writeToFile("D:\\QQ_File\\1719036792\\FileRecv\\tuanfei\\src\\main\\resources\\templates\\Img.docx");
compile.close();
}
打开img.docx文件,发现图片已经被填充进去了
填充表格
填充表格的时候,需要使用{{*var}}来填充表格。
还是一样,在指定的位置创建一个测试文档。我这边直接在springboot中的templates目录下创建一个名为TableTemplate.docx的文件。而文件中的内容为:
然后,编写测试方法,执行以下代码,进行表格的填充
@Test
public void test() throws IOException {
String path="D:\\QQ_File\\1719036792\\FileRecv\\tuanfei\\src\\main\\resources\\templates\\tableTemplate.docx";
//第一步:读取模板
XWPFTemplate compile = XWPFTemplate.compile(path);
//第二步:创建数据,用于把我们模板中的{{}}包裹的变量替换掉,map中保存的key一定要和模板中的变量保持一致
HashMap<String, Object> map = new HashMap<>();
//设置单元格,表头
RowRenderData header = RowRenderData.build(new TextRenderData("6495ED", "姓名"), new TextRenderData("6495ED", "学历"));
//设置表内容,如果在实际应用中,传入一个list集合或者数组,方可用foreach进行循环填充
RowRenderData row0 = RowRenderData.build("张三", "研究生");
RowRenderData row1 = RowRenderData.build(new TextRenderData("李四"), new TextRenderData("博士"));
RowRenderData row2 = RowRenderData.build("王五", "博士后");
map.put("table", new MiniTableRenderData(header, Arrays.asList(row0, row1, row2)));
compile.render(map);
compile.writeToFile("D:\\QQ_File\\1719036792\\FileRecv\\tuanfei\\src\\main\\resources\\templates\\table.docx");
compile.close();
}
执行成功后,在生成文件位置找到对应的文件,打开查看:
执行成功。。。。。
在实际开发中,我们经常会使用到Word的导出和数据填充。使用poi-tl,我们可以很轻松的就能对word文件进行操作。我写的这篇文章中只对我们常用的三种类型进行讲解。当我们需要更加了解和使用的时候,还是需要查看官方文档能更一步的了解和掌握poi-tl。
POI-TL1.5.x的文档地址:点击进入文档地址