SpringMVC上传下载文件解读

知识点

文件上传（File Upload）：

创建一个控制器方法，使用 MultipartFile 参数来接收上传的文件。
在 Spring 配置文件中配置一个 MultipartResolver，常用的实现类是 CommonsMultipartResolver。
在 MultipartResolver 的配置中设置最大允许上传文件的大小。
在控制器方法中，使用 MultipartFile 的方法获取上传文件的信息，如文件名、大小、内容等。
使用 MultipartFile 的 transferTo() 方法将上传的文件保存到指定位置。

文件下载（File Download）：

创建一个控制器方法，返回类型为 ResponseEntity<byte[]>，表示要下载的文件。
使用 HttpHeaders 类设置响应的头信息，包括文件名、文件类型等。
使用 Java IO 或其他工具类读取要下载的文件，并将内容设置到 ResponseEntity<byte[]> 中的字节数组中。
将包含文件内容和响应头信息的 ResponseEntity<byte[]> 对象作为控制器方法的返回值。

实现步骤

首先，在前端需要定义一个HTML表单来实现上传文件的功能：

<form action="upload" method="post" enctype="multipart/form-data"><input type="file" name="file"/><button type="submit">上传文件</button>
</form>

注意，表单的enctype属性必须设置为multipart/form-data，否则无法上传文件。

接下来，在后端需要编写控制器方法来处理上传文件的请求：

@Controller
public class FileController {@RequestMapping(value = "/upload", method = RequestMethod.POST)public String upload(@RequestParam("file") MultipartFile file) throws IOException {// 获取上传文件的名称String fileName = file.getOriginalFilename();// 文件保存路径String filePath = "path/to/save/" + fileName;// 将文件保存到磁盘上file.transferTo(new File(filePath));return "redirect:/success.html";}
}

在上述代码中，@RequestParam("file")注解表示获取名为file的上传文件。MultipartFile类是Spring提供的文件上传类，可以通过该类的方法获取上传文件的名称、大小等属性，并将文件保存到磁盘上。

在后端下载文件时，我们需要编写一个控制器方法来返回文件的字节数组：

@Controller
public class FileController {@RequestMapping("/download")public ResponseEntity<byte[]> download() throws IOException {// 获取要下载的文件路径String filePath = "path/to/download/file";// 读取文件内容到字节数组中byte[] bytes = Files.readAllBytes(Paths.get(filePath));// 构造响应头部信息，包括下载文件名和文件类型HttpHeaders headers = new HttpHeaders();headers.setContentDispositionFormData("attachment", "filename.txt");headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);// 返回字节数组和响应头部信息return new ResponseEntity<>(bytes, headers, HttpStatus.OK);}
}

在上述代码中，通过Files.readAllBytes()方法将文件内容读取到字节数组中，并使用ResponseEntity<byte[]>类封装字节数组和响应头部信息，最终返回给客户端进行下载。

在前端需要定义一个下载链接，用于触发下载文件的操作：

<a href="download">下载</a>

当用户点击该链接时，浏览器会发送一个请求到服务器，调用上述控制器方法来返回文件内容。浏览器会根据响应头部信息，自动弹出保存文件的对话框，让用户选择保存文件的位置。

可直接使用的Demo示例

@Controller
public class FileController {/*** 文件上传*/@RequestMapping("fileload")public String fileLoad(MultipartFile[] files,HttpServletRequest request) throws Exception {//设置上传的文件所存放的路径String path = request.getServletContext().getRealPath("/") + "files/";ObjectMapper mapper = new ObjectMapper();if (files != null && files.length > 0) {//循环获取上传的文件for (MultipartFile file : files) {//获取上传文件的名称String filename = file.getOriginalFilename();ArrayList<Resource> list = new ArrayList<>();//读取files.json文件中的文件名称String json = JSONFileUtils.readFile(path + "/files.json");if (json.length() != 0) {//将files.json的内容转为集合list = mapper.readValue(json,new TypeReference<List<Resource>>() {});for (Resource resource : list) {//如果上传的文件在files.json文件中有同名文件，将当前上传的文件重命名，以避免重名if (filename.equals(resource.getName())) {String[] split = filename.split("\\.");filename = split[0] + "(1)." + split[1];}}}// 文件保存的全路径String filePath = path + filename;// 保存上传的文件file.transferTo(new File(filePath));list.add(new Resource(filename));json = mapper.writeValueAsString(list); //将集合中转换成json//将上传文件的名称保存在files.json文件中JSONFileUtils.writeFile(json, path + "/files.json");}request.setAttribute("msg", "(上传成功)");return "forward:fileload.jsp";}request.setAttribute("msg", "(上传失败)");return "forward:fileload.jsp";}@ResponseBody@RequestMapping(value = "/getFilesName",produces = "text/html;charset=utf-8")public String getFilesName(HttpServletRequest request,HttpServletResponse response) throws Exception {String path = request.getServletContext().getRealPath("/") + "files/files.json";String json = JSONFileUtils.readFile(path);return json;}/*** 根据浏览器的不同进行编码设置，返回编码后的文件名*/public String getFileName(HttpServletRequest request,String filename) throws Exception {BASE64Encoder base64Encoder = new BASE64Encoder();String agent = request.getHeader("User-Agent");if (agent.contains("Firefox")) {// 火狐浏览器filename = "=?UTF-8?B?" + new String(base64Encoder.encode(filename.getBytes("UTF-8"))) + "?=";} else {// IE及其他浏览器filename = URLEncoder.encode(filename, "UTF-8");}return filename;}/*** 文件下载*/@RequestMapping("/download")public ResponseEntity<byte[]> fileDownload(HttpServletRequest request,String filename) throws Exception {System.out.println("123");System.out.println(filename);filename = java.net.URLDecoder.decode(filename, "utf-8");System.out.println(filename);// 指定要下载的文件所在路径String path = request.getServletContext().getRealPath("/files/");// 创建该文件对象System.out.println(filename);File file = new File(path + File.separator + filename);// 设置响应头HttpHeaders headers = new HttpHeaders();filename = this.getFileName(request, filename);// 通知浏览器以下载的方式打开文件headers.setContentDispositionFormData("attachment", filename);// 定义以流的形式下载返回文件数据System.out.println(filename);headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);// 使用Sring MVC框架的ResponseEntity对象封装返回下载数据return new ResponseEntity<byte[]>(FileUtils.readFileToByteArray(file),headers, HttpStatus.OK);}}

文件上传功能：

文件上传方法名为 fileLoad，通过 @RequestMapping 注解指定了请求地址为 "fileload"。该方法使用了 Spring 框架提供的 MultipartFile 类型来接收上传的文件，同时通过 HttpServletRequest 对象获取当前请求的上下文路径，并在该路径下创建一个名为 "files" 的文件夹用于保存上传的文件。该方法还使用了 Jackson 库中的 ObjectMapper 类将集合对象转化为 JSON 格式字符串，并通过封装好的 JSONFileUtils 工具类写入到 files.json 文件中保存。

文件下载功能：

文件下载方法名为 fileDownload，通过 @RequestMapping 注解指定了请求地址为 "download"。该方法通过 HttpServletRequest 对象获取当前请求的上下文路径，然后构造一个文件对象，通过 ResponseEntity 类型封装该文件返回给客户端进行下载。在该方法中还有一个 getFileName 方法，用于在不同浏览器中对文件名进行编码处理，避免出现乱码问题。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>文件上传和下载</title><script src="${ pageContext.request.contextPath }/js/jquery-3.6.0.js" type="text/javascript"></script>
</head>
<body>
<table border="1"><tr><td width="200" align="center">文件上传${msg}</td><td width="300" align="center">下载列表</td></tr><tr><td height="100"><form action="${pageContext.request.contextPath}/fileload"method="post" enctype="multipart/form-data"><input type="file" name="files" multiple="multiple"><br/><input type="reset" value="清空"/><input type="submit" value="提交"/></form></td><td id="files"></td></tr>
</table>
</body>
<script>$(document).ready(function () {var url = "${pageContext.request.contextPath }/getFilesName";$.get(url, function (files) {var files = eval('(' + files + ')');for (var i = 0; i < files.length; i++) {result=files[i].namefiles[i].name=encodeURI(files[i].name);files[i].name=encodeURI(files[i].name);$("#files").append("<li>" +"<a href=${pageContext.request.contextPath }" + "" +"\\" + "download?filename=" + files[i].name + ">" +result + "</a></li>");}})})
</script>
</html>

页面包含一个表格，其中第一行为文件上传的部分，第二行为文件下载列表的部分。在文件上传的部分，用户可以选择要上传的文件，并通过提交按钮将文件上传到服务器。在文件下载列表的部分，页面通过 AJAX 异步请求获取服务器端返回的文件列表数据，并使用 jQuery 库对数据进行处理和展示。

在 <script> 标签中的 JavaScript 代码中，首先通过 $.get() 方法发送 GET 请求获取服务器返回的文件列表数据，然后遍历文件列表，将每个文件的名称作为链接展示在页面上。点击链接时，会跳转到下载功能的地址，并将文件名作为参数传递给下载功能。需要注意的是，为了避免文件名中的特殊字符引起的问题，JavaScript 代码中使用了 encodeURI() 方法对文件名进行编码处理。

演示具体：