SpringMVC 文件的上传、下载

文件上传

（1）下载添加2个jar包

• commons-fileupload.jar
• commons-io.jar

SpringMVC的文件上传依赖于Apache的FileUpload组件，需要下载添加2个jar包，下载地址：

http://commons.apache.org/proper/commons-fileupload/

http://commons.apache.org/proper/commons-io/

（2）表单

  <form action="${pageContext.request.contextPath}/fileUpload" method="post" enctype="multipart/form-data">
    选择文件：<input name="uploadFile" type="file" multiple /><br />
    <button type="submit">上传</button>
  </form>

multiple用于文件多选，不使用multiple则只能选择一个文件。

（3）controller

@org.springframework.stereotype.Controller
public class FileUploadController{

    @RequestMapping("/fileUpload")
    public String fileUpload(@RequestParam("uploadFile") List<MultipartFile> fileList, HttpServletRequest request) {
        //如果用户上传了文件
        if (!fileList.isEmpty() && fileList.size()>0){
            System.out.println(fileList.isEmpty());
            System.out.println(fileList.size());
            //设置保存路径为项目根目录下的upload文件夹
            String savePath = request.getServletContext().getRealPath("/upload");
            //不存在就新建
            File saveDir = new File(savePath);
            if (!saveDir.exists()){
                saveDir.mkdirs();
            }

            //循环读取上传文件并保存
            for (MultipartFile file:fileList){
                //原文件名
                String originalFilename = file.getOriginalFilename();
                //使用uuid防止文件重名，因为原文件名中包含扩展名，只能放最后面
                String newFilename= UUID.randomUUID()+"_"+originalFilename;
                System.out.println(originalFilename);
                //将临时文件保存至指定目录
                try {
                    file.transferTo(new File(saveDir+"/"+newFilename));
                } catch (IOException e) {
                    e.printStackTrace();
                    return "error";
                }

            }
            return "success";
        }
        //如果用户未上传文件，返回error
        return "error";
    }

}

SpringMVC用MultipartFile来封装上传文件，一个MultipartFile对应一个上传文件。

（4）SpringMVC的配置文件

<?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:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!--包扫描-->
    <context:component-scan base-package="com.chy.controller" />

    <!--注解驱动，自动注册HandlerMapping、HandlerAdapter-->
    <mvc:annotation-driven />

    <!--视图解析器-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!--前缀-->
        <property name="prefix" value="/WEB-INF/jsp/" />
        <!--后缀-->
        <property name="suffix" value=".jsp" />
    </bean>

    <!-- 配置MultipartResolver，bean的id或name必须为multipartResolver -->
    <bean name="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <!-- 上传文件使用的编码字符集-->
        <property name="defaultEncoding" value="utf-8" />
        <!-- 所允许上传文件的最大尺寸，单位字节-->
        <property name="maxUploadSize" value="10485760" />
    </bean>

</beans>

只需配置MultipartResolver。

---

文件下载

（1）前端传递文件名

<a href="${pageContext.request.contextPath}/download?filename=1.jpg">下载文件</a>

（2）controller

@org.springframework.stereotype.Controller
public class DownloadController{

    @RequestMapping("/download")
    public ResponseEntity<byte[]> fileDownload(HttpServletRequest request,String filename) throws IOException {
        //指定存放文件的路径，此路径是在部署项目下，/表示部署项目的根路径
        String dir=request.getServletContext().getRealPath("/files");
        File file = new File(dir + "/" + filename);

        //设置响应头
        HttpHeaders httpHeaders = new HttpHeaders();
        //通知浏览器以下载的方式处理，第二个参数指定文件名
        httpHeaders.setContentDispositionFormData("attachment", filename);
        //以流的形式返回
        httpHeaders.setContentType(MediaType.APPLICATION_OCTET_STREAM);

        //读取目标文件
        byte[] arr = FileUtils.readFileToByteArray(file);
        //创建ResponseEntity对象并返回。目标文件的byte[]、HttpHeaders、Http状态码
        return new ResponseEntity<>(arr, httpHeaders, HttpStatus.OK);
    }

}

读取目标文件为byte[ ]，使用的FileUtils是commons-io.jar中的类，所以要添加commons-io.jar。

也可以使用jdk自带的方式读取目标文件为byte[ ]：

    FileInputStream fileInputStream = new FileInputStream(file);
    byte[] arr = fileInputStream.readAllBytes();

不需要添加额外的jar包。

---

解决下载文件，中文文件名乱码的问题

上面的代码，如果文件名中有中文，文件名会乱码。

原因在于此句代码中的文件名未指定编码字符集：

httpHeaders.setContentDispositionFormData("attachment", filename);

浏览器拿到文件名，发现没有指定字符集，就使用浏览器默认的字符集，

很多浏览器的默认字符集是ISO-8859，不包含中文字符，无法处理文件名里的中文，从而文件名乱码。

解决方式：

httpHeaders.setContentDispositionFormData("attachment", URLEncoder.encode(filename,"utf-8"));

对文件名使用utf-8编码。

此种方式只对部分浏览器有效。

不同的浏览器，默认的编码字符集可能不同，解决方式也可能不同，需要根据User-Agent（浏览器内核）来分别处理。