当前位置：首页 > news >正文

SpringMVC | SpringMVC中的 “文件上传和下载”

news 来源：原创 2024/5/17 13:46:12

- 一、文件上传
- - 1.1 文件上传“概述”
  - 1.2 文件上传“具体配置” :
  - - “前端”中配置“文件上传” ( type=“file” + 满足3个条件 )
    - “后端”中配置“文件上传” ( 配置id为“CommonsMultipartResolver”的bean + 配置“文件上传”的“约束条件” + 通过“MultipartFile接口”参数接收“传来的文件”)
  - 1.3 文件上传“应用案例” ：
  - - 文件上传 (存储在“相对路径”)
    - 文件上传 (存储在“绝对路径”)
- 二、文件下载
- - 2.1 实现“文件下载” ( “不可”下载“非中文名称”文件 )
  - 2.2 “中文名称”的文件下载 ( “可”下载“中文名称”文件 )

在这里插入图片描述

作者简介 ：一只大皮卡丘，计算机专业学生，正在努力学习、努力敲代码中! 让我们一起继续努力学习！

该文章参考学习教材为：
《Java EE企业级应用开发教程 (Spring + Spring MVC +MyBatis)》 黑马程序员 / 编著
文章以课本知识点 + 代码为主线，结合自己看书学习过程中的理解和感悟，最终成就了该文章

文章用于本人学习使用 ，同时希望能帮助大家。
欢迎大家点赞👍 收藏⭐ 关注💖哦！！！

（侵权可联系我，进行删除，如果雷同，纯属巧合）

一、文件上传

1.1 文件上传“概述”

上文件的上传和下载是项目开发中 最常用的功能，例如图片的上传与下载、邮件附件的上传与下载等。

1.2 文件上传“具体配置” :

“前端”中配置“文件上传” ( type=“file” + 满足3个条件 )

多数文件上传 都是通过 表单形式 提交给 后台服务器 的，因此，要实现文件上传功能，就需要提供一个 文件上传的表单，而 该表单 必须 满足以下3个条件 :

① form表单的method属性设置为post
② form表单的enctype属性 (编码方式) 设置为 multipart/form-data (多部分/表单数据)
③ 提供 <input type=”file” name=filename" multiple=“multiple”/> 的 文件上传输入框。

ps ：
multiple=“multiple” 为可选属性，表示可以 一次性选择多个文件来上传 。
文件上传 表单的 示范代码 如下： (“前端”中配置“文件上传”)
<%-- 通过表单的方式进行文件上传--%>
<form action="/uploadUrl" method="post" enctype="multipart/form-data">
<%--  multiple="multiple 为可选属性，表示一次可以选择多个文件上传  --%><input type="file" name="filename" multiple="multiple">
</form>
上述代码中，除了满足上传表单必须的3个条件外，在 <input>元素中还增加了一个 multiple属性，该属性是HTML5的新属性，如果使用了该属性，则可以同时选择多个文件进行上传，即 “多文件上传”。

当客户端form表单的 enctype属性 (multipart/form-data)为 multipart/form-data 时，浏览器 就会采用 二进制流 的方式来 处理表单数据，服务器端 就会对 文件上传的请求进行解析处理。

“后端”中配置“文件上传” ( 配置id为“CommonsMultipartResolver”的bean + 配置“文件上传”的“约束条件” + 通过“MultipartFile接口”参数接收“传来的文件”)

Spring MVC中为文件上传提供了直接的支持，这种支持是通过 MultipartResolver (多部件解析器) 对象实现的。MultipartResolver ( 多部件解析器 )是一个接口对象，需要通过它的 实现类 : CommonsMultipartResolver 来完成 文件上传工作。在Spring MVC中使用 MultipartResolver对象非常简单，只需要在配置文件中定义MultipartResolver接口 的 Bean 即可。

(配置 id 为 “CommonsMultipartResolver”的bean )

除了配置 CommonsMultipartResolver类之外，还可以通过 <property>元素配置“文件上传”的“约束条件” ，具体 “文件上传”的“约束条件” 如下：

约束条件描述
<property name=“defaultEncoding” value=“xxx”/> 配置 “请求编码格式”，必须与JSP中的 pageEncoding 的 属性一致，默认是 ISO-8859-1。
<property name=“maxUploadSize” value=“xxx”/> 设置 上传文件 的 最大长度，单位为 “字节”。
<property name="maxInMemorySize" value=“xxx”/> 设置 “缓存中” 的 最大尺寸。
ps :
maxInMemorySize ：最大内存大小。
<property name=“resolveLazily” value=“xxx”/> 推迟文件解析，以便在 Controller 中 捕获文件大小异常。

例子如 : ( springmvc-config.xml 中配置 “文件上传” )
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsd">


<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">

<property name="defaultEncoding" value="UTF-8"/>


<property name="maxUploadSize" value="2097152"/>
</bean></beans>
在上述配置代码中，配置了 CommonsMultipartResolver类 外，还通过 <property>元素配置了 编码格式 和 允许上传文件的大小。

注意 :

因为MuliparResolver接口的实现类CommonsMulipartResolver内部是引用muliparReolver字符
串获取该实现类对象并完成文件解析的，所以在配置CommonsMulipartResolver时必须指定该Bean的id为mulipartResolver。
由于 CommonsMultipartResolver 是SpringMVC内部通过 Apache Commons FileUpload 技术实现的，所以 SpringMVC的文件上传 还 需要依赖Apache Commons FileUpload的组件，即需要导入支持文件上传的相关JAR包，具体如下 :

commons-fileupload-1.3.2.jar
commons-io-2.5.jar
SpringMVC所需JAR
SpringMVC中“文件上传”和“下载”所需JAR
后端处理器方法 中是通过 “MultipartFile接口”类型参数 来 接收前端传来的文件的，例子如下 ：
package com.myh.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;@Controller //将该被设置为"处理器"类
public class FileUploadController { //文件上传的“控制器类”@RequestMapping("/fileUpload")//使用@RequestParam("前端参数名")注解注解“前后端参数名不一致的问题”，让数据之间能够完成映射/赋值//通过"MultipartFile接口"来接受前端传来的文件public String handlerFormUpload(@RequestParam("filename") MultipartFile file) { //MultipartFile 是一个接口if (!file.isEmpty()) { //如果文件不为空//具体的执行方法...return "uploadSuccess";}return "uploadFailure";}
}
在上述代码中，包含一个 MultipartFile接口类型 的参数file，(前端)上传到程序中的文件就是被封装在该参数中 ( MultipartFile接口 )的。org.springframework. web mutipart.MultipartFile接口中提供了 获取上传文件 、文件名称等方法，这些方法及其说明如下表示 :

MultipartFile接口中的主要方法 :

方法说明
byte[ ] getBytes( ) 以 字节数组 形式 返回文件 的内容。
String getContentType( ) 返回文件的 内容类型。
InputStream getInputStream( ) 读取文件内容，返回一个InputStream流。
String getName( ) 获取 多部件form表单 的 参数名称。
String getOriginalFilename( ) 获取 上传文件 的 初始化名。
long getSize( ) 获取 上传文件的大小，单位是字节。
boolean isEmpty( ) 判断 上传的文件是否为空。
void transferTo( File file ) 将 上传的文件 保存到目标目录下。
ps :
该方法中的 File参数，本质为 “上传文件”的“存储地址信息”，因为 MultipartFile接口 就代表“ 上传文件本身”。

约束条件	描述
<property name=“defaultEncoding” value=“xxx”/>	配置 “请求编码格式”，必须与JSP中的 pageEncoding 的属性一致，默认是 ISO-8859-1。
<property name=“maxUploadSize” value=“xxx”/>	设置上传文件的最大长度，单位为 “字节”。
<property name="maxInMemorySize" value=“xxx”/>	设置 “缓存中” 的最大尺寸。 ps : maxInMemorySize ：最大内存大小。
<property name=“resolveLazily” value=“xxx”/>	推迟文件解析，以便在 Controller 中捕获文件大小异常。

方法	说明
byte[ ] getBytes( )	以字节数组形式返回文件的内容。
String getContentType( )	返回文件的内容类型。
InputStream getInputStream( )	读取文件内容，返回一个InputStream流。
String getName( )	获取多部件form表单的参数名称。
String getOriginalFilename( )	获取上传文件的初始化名。
long getSize( )	获取上传文件的大小，单位是字节。
boolean isEmpty( )	判断上传的文件是否为空。
void transferTo( File file )	将上传的文件保存到目标目录下。 ps : 该方法中的 File参数，本质为 “上传文件”的“存储地址信息”，因为 MultipartFile接口就代表“ 上传文件本身”。

1.3 文件上传“应用案例” ：

文件上传 (存储在“相对路径”)

第一步、导入依赖 ：
SpringMVC所需JAR
SpringMVC中“文件上传”和“下载”所需JAR
第二步、配置具体操作代码文件 ：

web.xml ：
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"version="4.0"><servlet><servlet-name>dispatcherServlet</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:springmvc-config.xml</param-value></init-param><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>dispatcherServlet</servlet-name><url-pattern>/</url-pattern></servlet-mapping></web-app>
springmvc-config.xml ：
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/context"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"><mvc:component-scan base-package="com.myh.controller"/><bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"><property name="prefix" value="/WEB-INF/jsp/"/><property name="suffix" value=".jsp"/></bean><bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"><property name="defaultEncoding" value="UTF-8"/></bean></beans>
FileUploadController.java ：
package com.myh.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;import javax.servlet.http.HttpServletRequest;
import java.io.File;
import java.io.IOException;
import java.util.List;
import java.util.UUID;/*** 文件上传 (相对路径)*/
@Controller
public class FileUploadController {/*** 执行文件上传*/@RequestMapping("/fileUpload")public String handldFormUpload(@RequestParam("username") String username , @RequestParam("file") List<MultipartFile> uploadfiles,HttpServletRequest request) {//判断所上传的文件是否存在if (!uploadfiles.isEmpty() && uploadfiles.size() > 0) {//循环输出上传的文件for (MultipartFile multipartFile : uploadfiles) {//获得上传文件的原始名String originalFilename = multipartFile.getOriginalFilename();/*** 设置上传文件的"保存地址"*///从HTTP请求对象中获取ServletContext对象，然后使用ServletContext对象的.getRealPath()方法来获得“真实路径”。String dirPath = request.getServletContext().getRealPath("/upLoadFile/"); //会在out目录下的打包的项目的“根目录”下创建该文件夹，用于存储文件File filePath = new File(dirPath);//如果保存文件的地址不存在，则先创建目录if (!filePath.exists()) {filePath.mkdirs(); //创建目录(创建文件夹)}//使用UUID重新命名上传的文件名称(上传人_uuid_原始文件名称)/*UUID.randomUUID() 是Java中的一个方法，用于生成一个随机的、唯一的标识符（Universally Unique Identifier，简称UUID）*/String newFilename = username + UUID.randomUUID() + originalFilename;try {//使用MultipartFile接口的 transferTo()方法将文件上传到指定位置/*transferTo(File file) : 该方法中的参数本质上为“上传文件”的存储地址信息，因为multipartFile接口就代表“上传文件本身”*/multipartFile.transferTo(new File(dirPath + newFilename));System.out.println(new File(dirPath + newFilename));} catch (IOException e) {e.printStackTrace();return "error"; //返回错误页面}}//跳转成功页面return "success";} else {return "error";}}
}
在上述代码中，使用注解方式定义了一个控制器类，并在类中定义了执行文件上传的方法 :
handleFormUpload( )。在handleFormUpload( )方法参数中使用了List<MultipartFile>集合类型
来接收用户上传的文件，然后判断所上传的文件是否存在。如果存在，则继续执行上传操作，在通过MultipartFile接口的transferTo( )方法将上传文件保存到 用户指定的目录位置 ，会跳转到success.jsp页面；如果文件不存在或者上传失败，则跳转到error.jsp页面。

注意点 ：
此处 文件存储的路径 为 “相对路径” ，即 /upLoadFile/ : 如果该文件夹还没存在，会先在 “项目打包后 的 根目录 创建一个 文件夹 : upLoadFile, 然后将 “上传的文件” 存储到该文件夹中) ，upLoadFile文件夹 (是 相对路径 ) 位置展示如下图所示 ：

FileUpload.jsp ：
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>文件上传</title><script>//判断是否填写上传人并已选择上传文件function check() {var username = document.getElementById("username").value;var file = document.getElementById("file").value;if (username == "") {alert("请填写上传人！");return false;}if (file.length == 0 || file == "") {alert("请选择上传文件！");return false;}return true;}</script>
</head>
<body>
<%--οnsubmit="return check()" : 只有check()方法的返回值为true，才会正常提交表单(才会访问url)
--%>
<form action="${pageContext.request.contextPath}/fileUpload" enctype="multipart/form-data" method="post" onsubmit="return check()">上传人:<input type="text" id="username" name="username"></br>请选择文件:<input type="file" id="file" name="file" multiple="multiple"></br><input type="submit" value="上传"></form>
</body>
</html>
在文件中，编写了一个用于文件上传的fom表单，该表单可以填写上传人并上传文件，当单击“上传” 按钮时，会先执行ceck方法来检查上传 人文本框和文件选择框中内容是否为空，只有填写了上传人并选择了需要上传的文件后，才能正常提交表单；否则表单将不会提交，并给相应提示信息 （οnsubmit="return check() ：只有方法中返回值为true，才会提交表单）。 提交表单后，会以POST方式提交到一个以”/fileUpload”结尾的请求中。

error.jsp ：
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>error页面</title>
</head>
<body>
error!
</body>
</html>
success.jsp ：
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>success页面</title>
</head>
<body>
ok!
</body>
</html>
将 项目发布到Tomcat服务器中并启动，在浏览器中访问地址 : http://localhost:8080/FileUpload.jsp 其显示效果如下图所示 :

在上面的 “上传页面” 中，填写 上传人 并选择所要 上传的文件，单击 “上传” 按钮后就可向后台发送上传请求信息。

单击 “上传”按钮，程序在正确执行后浏览器 就会跳转到 success.jsp 页面，此时查看项目的发布项目 ，即 可发现 在：
S:\2024项目\SpringMVC中的“文件上传”和“下载”\out\artifacts\SpringMVC_Web_exploded下 ( 能 在idea找到该文件夹，所以属于“相对路径”) 创建了一个名字为：upLoadFile 的 文件夹，同时 “前端上传的文件” 则存储在该文件夹 中。在IDEA中查看存储“上传文件”的upLoadFile文件夹:

注意点 ：

需要注意的是，upLoadFile文件夹 是在项目的 发布路径 / 打包路径 中，而不是创建的项目所在目录中：

文件上传 (存储在“绝对路径”)

文件上传 (存储在“绝对路径”) 的实现: 除了 FileUploadController.java 这个文件有不同之外，其他的都是相同的。（替换以下代码就是将“文件”存储在“绝对路径”）

/**
* 存储的是“绝对路径”，将上传的文件存储在D盘下的upLoadFile3文件夹下
*/
String dirPath = "D:/upLoadFile3/";

FileUploadController.java :

package com.myh.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;import javax.servlet.http.HttpServletRequest;
import java.io.File;
import java.io.IOException;
import java.util.List;
import java.util.UUID;/*** 文件上传 (绝对路径)*/
@Controller
public class FileUploadController2 {/*** 执行文件上传( 文件存储在"绝对路径")*/@RequestMapping("/fileUpload3")public String handldFormUpload(@RequestParam("username") String username , @RequestParam("file") List<MultipartFile> uploadfiles,HttpServletRequest request) {//判断所上传的文件是否存在if (!uploadfiles.isEmpty() && uploadfiles.size() > 0) {//循环输出上传的文件for (MultipartFile multipartFile : uploadfiles) {//获得上传文件的原始名String originalFilename = multipartFile.getOriginalFilename();/*** 存储的是“绝对路径”，将上传的文件存储在D盘下的upLoadFile3文件夹下*/String dirPath = "D:/upLoadFile3/";File filePath = new File(dirPath);//如果保存文件的地址不存在，则先创建目录if (!filePath.exists()) {filePath.mkdirs(); //创建目录(创建文件夹)}//使用UUID重新命名上传的文件名称(上传人_uuid_原始文件名称)/*UUID.randomUUID() 是Java中的一个方法，用于生成一个随机的、唯一的标识符（Universally Unique Identifier，简称UUID）*/String newFilename = username + UUID.randomUUID() + originalFilename;try {//使用MultipartFile接口的 transferTo()方法将文件上传到指定位置/*transferTo(File file) : 该方法中的参数本质上为“上传文件”的存储地址信息，因为multipartFile接口就代表“上传文件本身”*/multipartFile.transferTo(new File(dirPath + newFilename));System.out.println(new File(dirPath + newFilename));} catch (IOException e) {e.printStackTrace();return "error"; //返回错误页面}}//跳转成功页面return "success";} else {return "error";}}
}

二、文件下载

2.1 实现“文件下载” ( “不可”下载“非中文名称”文件 )

文件下载 就是将 文件服务器 中的 文件下载到本机上。在SpringMVC环境中，实现文件下载 大致可分为 如下两个步骤 ：

① 在 客户端页面 使用一个 文件下载 的 超链接，该链接的 href属性 要指定后台文件下载的方法以及 文件名 (需要先在文件下载目录中添加了一个名称为 “1.jpg"的文件 )，具体代码示例如下 :
<a href="${pageContext.request.contextPat}/download?filename=1.jpg"> 文件下载
</a>
② 在后台 Controller类 中，使用 SpringMVC 提供的 文件下载方法 进行 文件下载。SpringMVC提供了一个 ResponseEntity类型的对象，使用它可以很方便地定义返回的 HttpHeaders对象 和 HttpStatus对象，通过对这两个对象的设置，即 可完成下载文件时所需的配置信息。

文件下载的示例代码 如下所示 :
package com.myh.controller;import org.apache.commons.io.FileUtils;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;import javax.servlet.http.HttpServletRequest;
import java.io.File;
import java.io.IOException;/*** 文件下载
*/
@Controller
public class FileDownLoadController {@RequestMapping("/download")public ResponseEntity<byte[]> fileDownload(HttpServletRequest request,String filename) throws IOException {//指定要下载的文件所在的路径 (即存储文件的路径) --此时用的是“相对路径”String path = request.getServletContext().getRealPath("/upLoadFile/");//创建该对象File file = new File(path + File.separator + filename);//设置"响应头"HttpHeaders headers = new HttpHeaders();//通知浏览器“以下载的方式”打开文件headers.setContentDispositionFormData("attachment", filename);//定义"以流的形式下载"返回文件数据headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);//使用Spring MVC框架的 ResponseEntity对象封装"下载数据"ResponseEntity<byte[]> responseEntity = new ResponseEntity<>(FileUtils.readFileToByteArray(file), headers, HttpStatus.OK);return responseEntity;}
}
在 fileDownload( )方法 中，首先根据 文件路径 和需要下载的 文件名 来 创建文件对象，然后对 响应头 中 文件下载时的打开方式 以及 下载方式 进行了设置，最后返回 ResponseEntity封装 的 下载结果对象。

ResponseEntity对象 有些类似前面章节介绍的 @ResponseBody注解，它用于 直接返回结果对象。上面示例中，设置 响应头信息 中MediaType代表的是Interner Media Type (即互联网媒体类型)，也叫作MIME类型, MediaType.APPLICATION_OCTET_STREAM的值为 application/octet-stream，即表示以 二进制流的形式下载数据；
HttpStatus 类型代表的是Http协议中的状态，示例中的 HttpStatus.OK 表示 200 ，即服务器 已成功处理了请求。

启动服务器后，访问网址 ：http://localhost:8080/FileDownLoad.jsp ，其显示效果如下图所示 ：

点击“文件下载”链接后，会出现下载提示弹窗，如下图所示 ：

此时，点击“下载”即可下载该文件。

2.2 “中文名称”的文件下载 ( “可”下载“中文名称”文件 )

虽然在 实现“文件下载”案例 中能通过 Spring MvC实现了文件下载功能，但 此案例代码 只适用于非中名称的文件进行下载，当对中文名称的文件进行下载时，因为各个浏览器内部转码机制的不同，就会出现 不同的乱码以及解析异常问题。例如在文件下载目录中添加一个名称为“壁纸.jpg” 的文件，当通过浏览器下载该文件时，下载弹出窗口的显示如下图所示 :

从上图可以看出，所要下载的文件名称并不是壁纸.jpg，而是“_.jpg"，这就表示 中文文件名称出现了乱码。那么我们要如何解决这种乱码问题呢?
为了 解决浏览器中文件下载 时 中文名称的乱码问题，可以在 ① 前端页面发送请求前 先 对中文名进行统一编码，然后在 ② 后台控制器类中对文件名称进行相应的转码，其 具体实现步骤如下 :
① 在 下载页面中对中文文件名编码。可以使用ServletAPI中提供的 URLEncoder类 ( URL编码器 )中的 encoder( String s, String enc )方法将中文转为UTF-8编码。该方法中第一个参数表示 需要转码的字符串，
第二个参数表示 编码格式，其具体实现方式如下代码所示：

FileDownLoad.jsp :
<%@ page import="java.net.URLEncoder" %>
<%@ page contentType="text/html;charset=UTF-8" language="java" pageEncoding="UTF-8" %>
<html>
<head><title>文件下载(下载中文名称文件)</title>
</head>
<body>
<%--<%= URLEncoder.encode("壁纸.jpg","UTF-8") %> : 其作用为:通过URLEncoder(URL编码器)的,encode()方法来对“中文文件名称”进行“转码”
--%>
<a href="${pageContext.request.contextPath}/download2?filename=<%= URLEncoder.encode("壁纸.jpg","UTF-8") %>">“中文名称”文件下载
</a>
</body>
</html>
② 修改控制器类FileUploadController 中的fileDownload( )方法，并 增加对文件名进行编码的方法，其代码如下所示 :

FileDownLoadController2.java ：
package com.myh.controller;import org.apache.commons.io.FileUtils;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;import javax.servlet.http.HttpServletRequest;
import java.io.File;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;/*** 文件下载 (下载中文名称文件)*/
@Controller
public class FileDownLoadController2 {@RequestMapping("/download2")public ResponseEntity<byte[]> fileDownload(HttpServletRequest request,String filename) throws IOException {//指定要下载的文件所在的路径 (即存储文件的路径) --此时用的是“相对路径”String path = request.getServletContext().getRealPath("/upLoadFile/");//创建该文件对象File file = new File(path + File.separator + filename);/*** 对文件名编码，防止中文文件乱码*/filename = this.getFilename(request,filename);//设置"响应头"HttpHeaders headers = new HttpHeaders();//通知浏览器“以下载的方式”打开文件headers.setContentDispositionFormData("attachment", filename);//定义以流的形式下载返回文件数据headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);//使用Spring MVC框架的 ResponseEntity对象封装"下载数据"ResponseEntity<byte[]> responseEntity = new ResponseEntity<>(FileUtils.readFileToByteArray(file), headers, HttpStatus.OK);return responseEntity;}/***  根据浏览器的不同编码进行设置，返回编码后的文件名*/private String getFilename(HttpServletRequest request, String filename) throws UnsupportedEncodingException {//IE不同版本User-Agent中出现的关键词String[] IEBrowserKeyWords = {"MSIE", "Trident", "Edge"};//获取请求头代理信息String userAgent = request.getHeader("User-Agent");for (String keyWord : IEBrowserKeyWords) {if (userAgent.contains(keyWord)) {//IE内核浏览器，统一为UTF-8编码显示return URLEncoder.encode(filename, "UTF-8");}}//火狐等其他浏览器统一为ISO-8859-1编码显示return new String(filename.getBytes("UTF-8"), "ISO-8859-1");}
}
在方法getFilename( )中，由于IE浏览器在文件编码上与其他浏览器的方式不同，所以在中文编码设置上IE浏览器设置为UTF-8编码，而火狐等其他浏览器设置为ISO-8859-1编码。另外由于不同版本的IE浏览器，请求代理User-Agent中的关键字也略有不同，所以在判断IE浏览器时，需要特别意User-Agent中的关键字。

再次进行中文名的文件下载测试，如下图所示 ：