目录
前言
一、场景描述
1、打成jar包运行后模板找不到
2、文件只能下载一次
二、正确示范
1、Controller下载方法定义
2、文档生成
总结
前言
在前面的博客中，介绍了如何在Java中根据模板动态写入数据到word模板中，原文地址：Java使用poi-tl1.9.1生成Word文档的几个小技巧。这里给出的案例是直接生成到本地目录中，在实际项目开发过程中，一般会采用web请求的方式，动态的将数据设置到Word中，同时将文件下载到本地。
在基于SpringBoot的开发环境中，我们经常会将实际部署的包打包成jar包的形式进行部署。在以上的场景开发中，不知道您是否会遇到以下的问题。比如会遇到模板找不到报错，还有请求智能点击一次的问题产生。
本文将针对以上两种情况，分析并解决在SpringBoot环境中，将Poi-tl应用打包成jar后的实际运行问题进行解决。如果在平常开发过程中也遇到这种问题，可以试试博文的方案，看是否可以解决您的问题。
一、场景描述
1、打成jar包运行后模板找不到
java.io.FileNotFoundException: class path resource [report/temp.docx] cannot be resolved to absolute file path because it does not reside in the file system: jar:file:/ROOT/xxx.jar!/BOOT-INF/lib/xxx-2.1.jar!/report/temp.docx
at org.springframework.util.ResourceUtils.getFile(ResourceUtils.java:217)
at org.springframework.core.io.AbstractFileResolvingResource.getFile(AbstractFileResolvingResource.java:154)
...通常来说，如果遇到上述的这种异常错误信息，一般都是因为获取docx模板的代码不对导致的，知道了问题的关键就可以针对性进行解决。
解决方案
在springboot项目中，对于打成jar包后的项目，如果想正常访问resource目录下的文件，建议采用以下的代码进行修复。
InputStream is = this.getClass().getClassLoader().getResourceAsStream("report/temp.docx");
在word模板写入的时候，可以采用以下的代码：
template = XWPFTemplate.compile(is).render(map);XWPFTemplate模板在写出的时候，可以支持直接对一个输入流进行内容写入。
2、文件只能下载一次
在使用poi-tl生成word的时候，可能会遇到第一次请求下载文件是正常的，但是在第二次需要下载时浏览器则失去响应，就像假死一样。可能前端的小伙伴还会把锅刷到浏览器头上。这里需要注意的是，在进行IO读写的时候，千万要记得关流。
如果你也遇到这种失去响应的情况，通常是因为忘记关流了。这里分享一段错误的代码示范：
private String createReport() throws Exception{
String reportDir = RuoYiConfig.getProfile() + "/report";
InputStream is = null;
XWPFTemplate template = null;
FileOutputStream out = null;
try {
is = this.getClass().getClassLoader().getResourceAsStream("report/temp.docx");
Map<String, Object> map = new HashMap<String,Object>();
map.put("score", "28");
map.put("title", "测试任务");
map.put("type", "上半年综合测评");
map.put("status", "已完成");
map.put("time", "2023-07-18");
map.put("locpicture", new PictureRenderData(400, 300, "D:/image.jpg"));
map.put("urlImg", Pictures.ofUrl("https://p1.itc.cn/images01/20230418/5d13ab4a86c04a8dac668bf4129e1f0c.png", PictureType.PNG).size(400, 300).create());
ChartMultiSeriesRenderData sbqk = Charts
.ofMultiSeries("十六市区县情况", new String[] { "济南","青岛","烟台","威海"})
.addSeries("上报情况", new Double[] { 15.0,20.6,42.6,90.1})
.addSeries("查出情况", new Double[] { 12.0,15.3,28.6,80.1})
.create();
map.put("sbqk", sbqk);
ChartMultiSeriesRenderData sjzlpm = Charts
.ofMultiSeries("医院综合排名", new String[] { "山东大学齐鲁医院","山东省泰山医院","山东省第二人民医院","山东省第三医院"})
.addSeries("数据质量排名", new Double[] { 70.5,40.6,22.7,85.4})
.addSeries("价格质量排名", new Double[] { 80.5,75.6,72.7,85.4})
.create();
map.put("sjzlpm", sjzlpm);
ChartMultiSeriesRenderData qst = Charts
.ofMultiSeries("任务趋势", new String[] { "06-10","06-11","06-12","06-13","06-14","06-15"})
.addSeries("微信端", new Double[] { 70.5,40.6,22.7,85.4,700.0,40.8})
.addSeries("PC端", new Double[] { 80.5,50.6,62.7,45.4,200.0,140.8})
.addSeries("小程序端", new Double[] { 120.5,520.6,362.7,405.4,300.0,340.8})
.create();
map.put("qst", qst);
//柱状图、折线图共存
List<SeriesRenderData> seriesRenderData = new ArrayList<SeriesRenderData>(3);
SeriesRenderData series1 = new SeriesRenderData("GDP", new Double[] {70.5,40.6,22.7,85.4,700.0,40.8});
series1.setComboType(SeriesRenderData.ComboType.BAR);
seriesRenderData.add(series1);
SeriesRenderData series2 = new SeriesRenderData("人口", new Double[] {80.5,50.6,62.7,45.4,200.0,140.8});
series2.setComboType(SeriesRenderData.ComboType.BAR);
seriesRenderData.add(series2);
SeriesRenderData series3 = new SeriesRenderData("指数", new Double[] {0.6,0.6,0.7,0.4,0.7,0.8});
series3.setComboType(SeriesRenderData.ComboType.LINE);
seriesRenderData.add(series3);
ChartMultiSeriesRenderData hntb = Charts
.ofMultiSeries("某省社会排名", new String[] { "城市1","城市2","城市3","城市4","城市5","城市6"})
.create();
hntb.setSeriesDatas(seriesRenderData);
map.put("hntb", hntb);
template = XWPFTemplate.compile(is).render(map);
File reportDirFile = new File(reportDir);
if(!reportDirFile.exists()) {
reportDirFile.mkdir();
}
out = new FileOutputStream(new File(reportDir + "/生成报告结果.docx"));
template.write(out);
out.flush();
} catch (Exception e) {
}finally {
if(null != out)out.close();
if(null != template) template.close();
//if(null != is)is.close();
}
return reportDir + "/生成报告结果.docx";
}这里将is的流关闭一行注释掉，模拟流未关闭的情况。此时在浏览器中进行文件下载，大概率会得到一个无法下载的错误。
二、正确示范
为了方式大家在复制的过程中遇到错误的示范问题，这里给出一段参考代码，其中已经将核心敏感的数据进行处理掉，但具体的业务逻辑不变，供参考，模板信息如下。
1、Controller下载方法定义
在基于Ruoyi的SpringBoot项目开发中，需要定义一个用于接收前台请求的下载对象及处理方法，参考代码如下：
package com.ruoyi.project.demo.controller;
import java.io.File;
import java.io.FileOutputStream;
import java.io.InputStream;
import java.io.UnsupportedEncodingException;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import javax.servlet.http.HttpServletResponse;
import org.springframework.http.MediaType;
import org.springframework.stereotype.Controller;
import org.springframework.util.ResourceUtils;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import com.deepoove.poi.XWPFTemplate;
import com.deepoove.poi.data.ChartMultiSeriesRenderData;
import com.deepoove.poi.data.Charts;
import com.deepoove.poi.data.PictureRenderData;
import com.deepoove.poi.data.PictureType;
import com.deepoove.poi.data.Pictures;
import com.deepoove.poi.data.SeriesRenderData;
import com.ruoyi.common.utils.file.FileUtils;
import com.ruoyi.framework.config.RuoYiConfig;
import com.ruoyi.framework.web.controller.BaseController;
@Controller
@RequestMapping("/demo/wordownload")
public class WordDownLoadController extends BaseController{
@GetMapping("/test")
public void test(HttpServletResponse response) throws Exception {
String realFileName = "生成报告结果.docx";
String filePath = this.createReport();
response.setContentType(MediaType.APPLICATION_OCTET_STREAM_VALUE);
FileUtils.setAttachmentResponseHeader(response, realFileName);
FileUtils.writeBytes(filePath, response.getOutputStream());
}
}
2、文档生成
private String createReport() throws Exception{
String reportDir = RuoYiConfig.getProfile() + "/report";
InputStream is = null;
XWPFTemplate template = null;
FileOutputStream out = null;
try {
is = this.getClass().getClassLoader().getResourceAsStream("report/temp.docx");
Map<String, Object> map = new HashMap<String,Object>();
map.put("score", "28");
map.put("title", "测试任务");
map.put("type", "上半年综合测评");
map.put("status", "已完成");
map.put("time", "2023-07-18");
map.put("locpicture", new PictureRenderData(400, 300, "D:/image.jpg"));
map.put("urlImg", Pictures.ofUrl("https://p1.itc.cn/images01/20230418/5d13ab4a86c04a8dac668bf4129e1f0c.png", PictureType.PNG).size(400, 300).create());
ChartMultiSeriesRenderData sbqk = Charts
.ofMultiSeries("十六市区县情况", new String[] { "济南","青岛","烟台","威海"})
.addSeries("上报情况", new Double[] { 15.0,20.6,42.6,90.1})
.addSeries("查出情况", new Double[] { 12.0,15.3,28.6,80.1})
.create();
map.put("sbqk", sbqk);
ChartMultiSeriesRenderData sjzlpm = Charts
.ofMultiSeries("医院综合排名", new String[] { "山东大学齐鲁医院","山东省泰山医院","山东省第二人民医院","山东省第三医院"})
.addSeries("数据质量排名", new Double[] { 70.5,40.6,22.7,85.4})
.addSeries("价格质量排名", new Double[] { 80.5,75.6,72.7,85.4})
.create();
map.put("sjzlpm", sjzlpm);
ChartMultiSeriesRenderData qst = Charts
.ofMultiSeries("任务趋势", new String[] { "06-10","06-11","06-12","06-13","06-14","06-15"})
.addSeries("微信端", new Double[] { 70.5,40.6,22.7,85.4,700.0,40.8})
.addSeries("PC端", new Double[] { 80.5,50.6,62.7,45.4,200.0,140.8})
.addSeries("小程序端", new Double[] { 120.5,520.6,362.7,405.4,300.0,340.8})
.create();
map.put("qst", qst);
//柱状图、折线图共存
List<SeriesRenderData> seriesRenderData = new ArrayList<SeriesRenderData>(3);
SeriesRenderData series1 = new SeriesRenderData("GDP", new Double[] {70.5,40.6,22.7,85.4,700.0,40.8});
series1.setComboType(SeriesRenderData.ComboType.BAR);
seriesRenderData.add(series1);
SeriesRenderData series2 = new SeriesRenderData("人口", new Double[] {80.5,50.6,62.7,45.4,200.0,140.8});
series2.setComboType(SeriesRenderData.ComboType.BAR);
seriesRenderData.add(series2);
SeriesRenderData series3 = new SeriesRenderData("指数", new Double[] {0.6,0.6,0.7,0.4,0.7,0.8});
series3.setComboType(SeriesRenderData.ComboType.LINE);
seriesRenderData.add(series3);
ChartMultiSeriesRenderData hntb = Charts
.ofMultiSeries("某省社会排名", new String[] { "城市1","城市2","城市3","城市4","城市5","城市6"})
.create();
hntb.setSeriesDatas(seriesRenderData);
map.put("hntb", hntb);
template = XWPFTemplate.compile(is).render(map);
File reportDirFile = new File(reportDir);
if(!reportDirFile.exists()) {
reportDirFile.mkdir();
}
out = new FileOutputStream(new File(reportDir + "/生成报告结果.docx"));
template.write(out);
out.flush();
} catch (Exception e) {
}finally {
if(null != out)out.close();
if(null != template) template.close();
if(null != is)is.close();
}
return reportDir + "/生成报告结果.docx";
}总结
以上就是本文的主要内容，文章主要讲解了在SpringBoot中使用Poi-tl进行模板生成时，容易遇到的两个异常场景，以及针对性的给出了相应的解决方案。以上代码经过实际代码运行测试，可以正常使用。行文仓促，如有不当，尽请批评指正。
