前端实现文件下载功能有多种方法,这里就不一一介绍,这里只介绍使用文件流下载的实现方法。

既然是文件流那就肯定需要给前端返回一堆二进制编码,作为后端就可以返回一个OutPutStream

后端可以使用Java中servlet提供的HttpServletResponse,核心步骤是要设置响应的数据类型,设置为某一类文件类型或二进制格式,以及响应头,然后用ServletOutputStream将文件以流的形式发送到前端。

直接上代码

response.setCharacterEncoding("UTF-8");//统一编码,utf-8response.setContentType("application/vnd.ms-excel");//这是xls,旧excel文件类型//response.setContentType("application/octet-stream");//一种通用的二进制数据流response.setHeader("Content-Disposition", "attachment;filename=example.xls");//告诉浏览器将响应内容当作附件进行处理,从而触发文件下载。

解释一下

  1. 首先设置响应数据类型,你要下载什么文件就设置什么类型,如果你不知道文件是什么类型但可以肯定他不是文本文件,那就用下面的application/octet-stream表示,这样浏览器就知道这是一些二进制数据,就不会对其解析了。
  2. 其次是设置响应头:

attachment: 表示响应内容应该被当作附件处理,会触发浏览器下载行为。

filename:参数指定下载文件的名称。上述代码则会让浏览器下载一个example.xls的文件。

这里给大家放一个链接,里面有常见的MIME类型,常见 MIME 类型列表 例如下图,png类型,pdf,ppt等等。

然后就是用流的形式发送给前端

ServletOutputStream outputStream = response.getOutputStream();checkInfo.write(outputStream);//checkInfo是我写的一个方法返回值,其本身是poi包下的HSSFWorkbook类型,读者不必在意。outputStream.flush();

这样后端就完成了把一个文件以文件流的形式传递给前端,前端发起请求就会触发浏览器的下载行为。

下面是完整代码

@GetMapping("/output/{classId}/{checkName}")    public void checkToExcel(@PathVariable String checkName, @PathVariable String classId, HttpServletResponse response) {        HSSFWorkbook checkInfo = checkExcelService.getCheckInfo(classId, checkName);        response.setContentType("application/vnd.ms-excel");        response.setCharacterEncoding("UTF-8");        response.setHeader("Content-Disposition", "attachment;filename=" + checkName + "签到统计表.xls");        try {            ServletOutputStream outputStream = response.getOutputStream();            checkInfo.write(outputStream);            outputStream.flush();        } catch (IOException e) {            throw new RuntimeException(e);        }    }

不知道有没有朋友像我一样,方法的返回值写的是流(例如ByteArrayOutputStream)这么写就错了

我之前在写这个程序时就是向前端返回一个流,结果下载的文件始终格式错误,浏览器收到的响应数据类型也一直是json,原因就在于没有使用response发送流,所以一定要使用response.getOutputStream()获取流,然后再去flush,这样前端才真正收到的是二进制文件流。