【Java 实现文件下载】vue前端+java后端实现文件下载详解（附源码）-Toy模板网

这篇具有很好参考价值的文章主要介绍了【Java 实现文件下载】vue前端+java后端实现文件下载详解（附源码）。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

【写在前面】前端时间总结了一下有关java文件上传的功能，也给不少读者带来一些帮助，因此今天继续完善文件下载这套体系，希望能给屏幕前的您带来实质性的帮助，其实文件下载最怕的就是中文乱码的现象，当然这个我单独写了一篇文章解释，这里不做详谈。
涉及知识点：encode和decode，java文件下载，文件下载中文名乱码，FileInputStream。

实现效果

【Java 实现文件下载】vue前端+java后端实现文件下载详解（附源码）

1、功能分析

首先我们要做的是下载，和导出还是有一点区别的，下载是从目标路径（服务器）将指定的文件下载一份下来到客户端的过程。
所以首先我们必须得知道您要下载的文件存放路径及对应的文件名，这个可以是前端传递，也可以是在接口指定，当然一些固定的模板可以采用接口指定或者配置文件设置，要是一些动态的列表中下载指定的文件的话最好是前端传递。

Java中获取当前class路径的方式如下（我是获取之前上传后文件的路径，基于本地）：

String tempName="黄大大的街舞梦.xlsx";
String filePath=this.getClass().getResource("/template/"+tempName).getPath();

网上还有人说要根据不同浏览器的User-Agent属性值来做判断，但是我发现IE，Chrome，Edge都是可行的

2、代码实现

Java实现文件下载我们要从前后端两方面入手，且要确保目标路径下有你要的文件，不然也会下载失败的。

2.1 前端页面搭建（vue）

创建一个节点，主要用于触发文件下载接口，我用的是vant3的按钮，基于click事件进行触发，如下所示：

<van-button type="primary" @click="Download()">下载文件</van-button>

然后再在methods里面封装一个下载的方法，如下所示：

Download() {
      axios
        .get("/Updown/download", { responseType: "blob" })
        .then((response) => {
          console.log(response);
          //headers请求头的乱码数据转换为中文
          const fileName = decodeURI(
            response.headers["content-disposition"].split(";")[1].split("=")[1]
          );
          debugger;
          //下载文件
          let blob = new Blob([response.data], {
            type: "application/vnd.ms-excel",
          });
          let objectUrl = URL.createObjectURL(blob); // 创建URL
          const link = document.createElement("a");
          link.href = objectUrl;
          // link.download = '.xlsx'// 自定义文件名
          //这里是获取后台传过来的文件名
          link.setAttribute("download", fileName);
          link.click(); // 下载文件
          URL.revokeObjectURL(objectUrl); // 释放内存
        })
        .catch((error) => {
          console.log(error);
          alert("下载失败");
        });
    },

只有这个方法就可以实现下载功能

【前端划重点】

请求方式：get的方式（post方式暂时没有实测，后续更新）
响应类型：responseType: “blob”，二进制大对象类型，存储大量的二进制和文本的容器。
编码转换：decodeURI，主要是和java的encode对应，因为中文名需要转一下，不然乱码。

2.2 后台接口实现（java）

Java下载文件其核心在于FileInputStream文件字节输入流，也就是将文件变成机器识别的字节，然后通过read方法，从文件的第一个字节开始，read方法每执行一次，就会将一个字节读取，并返回该字节ASCII码。
另外针对中文我们要加一个encode的编码处理，方便传输不会出现中文名乱码的现象。
Java实现核心代码如下：

int len = filePath.lastIndexOf("/");
if (StringUtils.isBlank(filePath) || len == -1) {
    throw new Exception("未上传文件！");
}
String fileName = filePath.substring(len + 1);
File file = new File(filePath);
if (!file.exists()) {
    throw new Exception("文件不存在！");
}
fileName = URLEncoder.encode(fileName, "UTF-8");
try {
    response.setHeader("Content-disposition","attachment; filename="+ fileName);
    response.setContentType("application/vnd.ms-excel");
    response.setCharacterEncoding("UTF-8");
    OutputStream out = response.getOutputStream();
    BufferedInputStream fin = new BufferedInputStream(new FileInputStream(file));
    try {
        byte[] content = new byte[1024];
        int length;
        while ((length = fin.read(content, 0, content.length)) != -1) {
            out.write(content, 0, length);
        }
    } catch (Exception e) {
        logger.error(e.getMessage(), e);
        logger.info("文件下载失败", e.getMessage());
        throw e;
    } finally {
        fin.close();
        out.flush();
        out.close();
    }
} catch (Exception e) {
    logger.error(e.getMessage(), e);
    throw e;
}