Java实现批量下载(打包成zip)的实现

Z时代
2024-01-10
分类：综合

引言

批量下载思路，首先前端发送下载请求，携带必要参数，也可无参默认批量下载页面全部数据；后台接收后进行数据处理拿到要下载文件的下载地址，循环下载地址，用压缩流，将文件直接写入压缩包，最后利用文件下载将压缩包输出给前端。

一、前端JS发送下载请求

1、ajax无法发送下载请求

关于下载的常见需求无非就是点击按钮下载或者选中点击批量下载，点击下载或批量下载后，携带参数向后台发送下载请求，但是JS中的ajax无法触发浏览器的下载机制，这也是处于安全考虑，所以下载请求不可以通过发送ajax请求实现。

2、js发送下载请求：超链接方式

我们可以通过< a >标签实现，在a标签的href中拼接get请求并携带所需参数，如下


<a href="http://localhost:8080/download/?ids=123,234&fileName=down">下载</a>

批量下载，前端可以传每条数据的id，用逗号拼接成字符串，后台接收后进行数据处理，然后进行批量下载，但是此方式有局限性，如果我选中了很多条数据，每条数据的id都是32位UUID，那get请求无法携带大量参数，所以这种方式并不适合批量下载，只适合单条数据下载。

3、js发送下载请求：拼接Form表单，并提交

form表单也有局限性，例如form表单不能传输json格式的数据，也就是说用此方式提交，后台不能用@RequestBody注解


$('.download-btn').click(function () {
 // 如果要传选中行的id,则从页面获取到所有id,可以拿逗号拼接,放到输入框传给后台
 // 如果需要把选中行整行数据传到后台,form表单不支持传json格式数据,所以可以把
 // 选中行数据放入数组,转为json放入输入框,后台用String接收,然后再转回Obj
 var $dataForm = $(
 "<form type='hidden' method='post'>" +
 "<input type='hidden' id='ids' name='ids' value='" + ids + "' type='text'/>" +
 "</form>"
 );
 $dataForm.attr("action", 'localhost:8080/download');
 $(document.body).append($dataForm);
 //提交表单，实现下载
 $dataForm.submit();
});

如上边代码所示，传参为ids，那如果你想传obj，可以用JSON.stringify()将前端对象或数组类型转为json字符串，然后赋值给表单的输入框，一并提交给后台，后台用String接收，然后再转回Object，我在测试过程中 js提交数据到后台（json），" 被转译成了& quot;，如果你也遇到，请看这篇文章：文章链接

二、后台处理

此处省略接收参数，获取需要下载的文件的url，直接写死模拟：


@RequestMapping(value = "/download", method = RequestMethod.POST)
public void plistDownLoad(HttpServletResponse response) throws Exception {
 // 此处模拟处理ids,拿到文件下载url
 List<String> paths = new ArrayList<>();
 paths.add("C:\\Users\\E480\\Desktop\\Study\\casul笔记.txt");
 paths.add("C:\\Users\\E480\\Desktop\\Study\\config配置中心笔记.txt");
 paths.add("C:\\Users\\E480\\Desktop\\Study\\GateWay.txt");
 if (paths.size() != 0) {
 // 创建临时路径,存放压缩文件
 String zipFilePath = "D:\\workspace-IDEA\\zip\\我的zip.zip";
 // 压缩输出流,包装流,将临时文件输出流包装成压缩流,将所有文件输出到这里,打成zip包
 ZipOutputStream zipOut = new ZipOutputStream(new FileOutputStream(zipFilePath));
 // 循环调用压缩文件方法,将一个一个需要下载的文件打入压缩文件包
 for (String path : paths) {
  // 该方法在下面定义
  fileToZip(path, zipOut);
 }
 // 压缩完成后,关闭压缩流
 zipOut.close();
 //拼接下载默认名称并转为ISO-8859-1格式
 String fileName = new String(("我的压缩文件.zip").getBytes(),"ISO-8859-1");
 response.setHeader("Content-Disposition", "attchment;filename="+fileName);
 //该流不可以手动关闭,手动关闭下载会出问题,下载完成后会自动关闭
 ServletOutputStream outputStream = response.getOutputStream();
 FileInputStream inputStream = new FileInputStream(zipFilePath);
 // 如果是SpringBoot框架,在这个路径
 // org.apache.tomcat.util.http.fileupload.IOUtils产品
 // 否则需要自主引入apache的 commons-io依赖
 // copy方法为文件复制,在这里直接实现了下载效果
 IOUtils.copy(inputStream, outputStream);
 // 关闭输入流
 inputStream.close();
 //下载完成之后，删掉这个zip包
 File fileTempZip = new File(zipFilePath);
 fileTempZip.delete();
 }
}

将文件打包的方法，需要传一个压缩路径，和一个文件，一次只将一个文件写入压缩包


public static void fileToZip(String filePath,ZipOutputStream zipOut) throws IOException {
 // 需要压缩的文件
 File file = new File(filePath);
 // 获取文件名称,如果有特殊命名需求,可以将参数列表拓展,传fileName
 String fileName = file.getName();
 FileInputStream fileInput = new FileInputStream(filePath);
 // 缓冲
 byte[] bufferArea = new byte[1024 * 10];
 BufferedInputStream bufferStream = new BufferedInputStream(fileInput, 1024 * 10);
 // 将当前文件作为一个zip实体写入压缩流,fileName代表压缩文件中的文件名称
 zipOut.putNextEntry(new ZipEntry(fileName));
 int length = 0;
 // 最常规IO操作,不必紧张
 while ((length = bufferStream.read(bufferArea, 0, 1024 * 10)) != -1) {
 zipOut.write(bufferArea, 0, length);
 }
 //关闭流
 fileInput.close();
 // 需要注意的是缓冲流必须要关闭流,否则输出无效
 bufferStream.close();
 // 压缩流不必关闭,使用完后再关
}