SpringMVC之文件上传和下载

十一、文件上传和下载

目录：准备工作、文件上传、文件下载

1.准备工作

文件上传是项目开发中最常见的功能之一，SpringMVC可以很好的支持文件上传，但是SpringMVC上下文中默认没有装配MultipartResolver，因此默认情况下其不能处理文件上传工作。如果想使用Spring的文件上传功能，则需要在上下文中配置MultipartResolver。
前端表单要求：为了能上传文件，必须将表单的method设置为POST，并将enctype设置为multipart/form-data。只有在这样的情况下，浏览器才会把用户选择的文件以二进制数据发送给服务器。
对表单中的enctype属性做个详细的说明：
①application/x-www=form-urlencoded：默认方式，只处理表单域中的value属性值，采用这种编码方式的表单会将表单域中的值处理成URL编码方式。
②multipart/form-data：这种编码方式会以二进制流的方式来处理表单数据，这种编码方式会把文件域指定文件的内容也封装到请求参数中，不会对字符编码。
③text/plain：除了把空格转换为 “+” 号外，其他字符都不做编码处理，这种方式适用直接通过表单发送邮件。

<form action="" enctype="multipart/form-data" method="post">
  <input type="file" name="file"/>
  <input type="submit">
</form>

一旦设置了enctype为multipart/form-data，浏览器即会采用二进制流的方式来处理表单数据，而对文件上传的处理则涉及在服务器端解析原始的HTTP响应。在2003年，Apache Software Foundation发布了开源的Commons FileUpload组件，其很快成为Servlet/JSP程序员上传文件的最佳选择。
Servlet3.0规范已经提供方法来处理文件上传，但这种上传需要在Servlet中完成。而Spring MVC则提供了更简单的封装。Spring MVC为文件上传提供了直接的支持，这种支持是用即插即用的MultipartResolver实现的。Spring MVC使用Apache Commons FileUpload技术实现了一个MultipartResolver实现类：CommonsMultipartResolver。因此，SpringMVC的文件上传还需要依赖Apache Commons FileUpload的组件。

2.文件上传

1）导入文件上传的jar包，commons-fileupload， Maven会自动帮我们导入它的依赖包commons-io包。

<!--文件上传-->
<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.4</version>
</dependency>
<!--servlet-api导入高版本的-->
<dependency>
  <groupId>javax.servlet</groupId>
  <artifactId>javax.servlet-api</artifactId>
  <version>4.0.1</version>
</dependency>

2）配置bean，将id设置成multipartResolver。
注意：这个bean的id必须为multipartResolver，否则上传文件会报400的错误。

<!--文件上传配置-->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
  <!-- 请求的编码格式，必须和JSP的pageEncoding属性一致，以便正确读取表单的内容， 默认为ISO-8859-1 -->
  <property name="defaultEncoding" value="utf-8"/>
  <!-- 上传文件大小上限，单位为字节（10485760=10M） -->
  <property name="maxUploadSize" value="10485760"/>
  <property name="maxInMemorySize" value="40960"/>
</bean>

CommonsMultipartFile的常用方法：
ⅠString getOriginalFilename()：获取上传文件的原名。
ⅡInputStream getInputStream()：获取文件流。
Ⅲvoid transferTo(File dest)：将上传文件保存到一个目录文件中。
3）前端页面：

<form action="/upload" enctype="multipart/form-data" method="post">
  <input type="file" name="file"/>
  <input type="submit" value="upload">
</form>

4）Controller：

package com.ping.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.commons.CommonsMultipartFile; 
import javax.servlet.http.HttpServletRequest; 
import java.io.*; 
@Controller 
public class FileController { 
  //@RequestParam("file")将name=file控件得到的文件封装成CommonsMultipartFile对象 
  //批量上传CommonsMultipartFile则为数组即可 
  @RequestMapping("/upload") 
  public String fileUpload(@RequestParam("file") CommonsMultipartFile file , HttpServletRequest request) throws IOException { 
    //获取文件名：file.getOriginalFilename(); 
    String uploadFileName = file.getOriginalFilename(); 
    //如果文件名为空，直接回到首页
    if ("".equals(uploadFileName)){ 
      return "redirect:/index.jsp"; 
    }
    System.out.println("上传文件名 : "+uploadFileName); 
    //上传路径保存设置 
    String path = request.getServletContext().getRealPath("/upload"); 
    //如果路径不存在，创建一个 
    File realPath = new File(path); 
    if (!realPath.exists()){ 
      realPath.mkdir(); 
    }
    System.out.println("上传文件保存地址："+realPath); 
    InputStream is = file.getInputStream(); 
    //文件输入流 
    OutputStream os = new FileOutputStream(new File(realPath,uploadFileName)); //文件输出流 
    //读取写出 
    int len=0; 
    byte[] buffer = new byte[1024]; 
    while ((len=is.read(buffer))!=-1){ 
      os.write(buffer,0,len); 
      os.flush(); 
    }
    os.close();
    is.close(); 
    return "redirect:/index.jsp"; 
  } 
}

采用file.Transto来保存上传的文件：
①编写Controller。

/*
*采用file.Transto 来保存上传的文件 
*/ 
@RequestMapping("/upload2") 
public String fileUpload2(@RequestParam("file") CommonsMultipartFile file, HttpServletRequest request) throws IOException { 
  //上传路径保存设置 
  String path = request.getServletContext().getRealPath("/upload"); 
  File realPath = new File(path); 
  if (!realPath.exists()){ 
    realPath.mkdir(); 
  }
  //上传文件地址 
  System.out.println("上传文件保存地址："+realPath); 
  //通过CommonsMultipartFile的方法直接写文件
  file.transferTo(new File(realPath +"/"+ file.getOriginalFilename())); 
  return "redirect:/index.jsp"; 
}

②前端表单提交地址修改。
③访问提交测试。

3.文件下载

文件下载步骤：
①设置response响应头。
②读取文件：InputStream。
③写出文件：OutputStream。
④执行操作。
⑤关闭流 （先开后关）。
代码实现：

@RequestMapping(value="/download") 
public String downloads(HttpServletResponse response ,HttpServletRequest request) throws Exception{ 
  //要下载的图片地址 
  String path = request.getServletContext().getRealPath("/upload"); 
  String fileName = "基础语法.jpg";
  //设置response响应头 
  response.reset(); 
  //设置页面不缓存，清空buffer 
  response.setCharacterEncoding("UTF-8"); 
  //字符编码 
  response.setContentType("multipart/form-data"); 
  //二进制传输数据 
  //设置响应头 
  response.setHeader("Content-Disposition", "attachment;fileName="+URLEncoder.encode(fileName, "UTF-8")); 
  File file = new File(path,fileName); 
  //读取文件-输入流 
  InputStream input=new FileInputStream(file); 
  //写出文件-输出流
  OutputStream out = response.getOutputStream(); 
  byte[] buff =new byte[1024]; 
  int index=0; 
  //执行写出操作 
  while((index= input.read(buff))!= -1){
    out.write(buff, 0, index); 
    out.flush(); 
  }
  out.close(); 
  input.close(); 
  return null; 
}

前端：

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

测试后文件成功下载。