SpringMVC:文件上传和下载功能

前言
文件上传是项目开发中最常见的功能之一 ,springMVC 可以很好的支持文件上传,但是SpringMVC上下文中默认没有装配MultipartResolver,因此默认情况下其不能处理文件上传工作。如果想使用Spring的文件上传功能,则需要在上下文中配置MultipartResolver。
前端表单要求:为了能上传文件,必须将表单的method设置为POST,并将enctype设置为multipart/form-data。只有在这样的情况下,浏览器才会把用户选择的文件以二进制数据发送给服务器;


  1. 对表单中的 enctype 属性做个详细的说明:

    • application/x-www=form-urlencoded:默认方式,只处理表单域中的 value 属性值,采用这种编码方式的表单会将表单域中的值处理成 URL 编码方式。

    • multipart/form-data:这种编码方式会以二进制流的方式来处理表单数据,这种编码方式会把文件域指定文件的内容也封装到请求参数中,不会对字符编码。

    • text/plain:除了把空格转换为 “+” 号外,其他字符都不做编码处理,这种方式适用直接通过表单发送邮件。

    1
    2
    3
    4
    <form action="" enctype="multipart/form-data" method="post">
    <input type="file" name="file"/>
    <input type="submit">
    </form>
  2. 使用步骤

    • 1.导入文件上传的jar包,commons-fileupload , Maven会自动帮我们导入他的依赖包 commons-io包;

      代码如下:

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      <!--文件上传-->
      <dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>1.3.3</version>
      </dependency>
      <!--servlet-api导入高版本的-->
      <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>4.0.1</version>
      </dependency>
    • 2.配置bean:multipartResolver
      代码如下(示例):
      【注意!!!这个bena的id必须为:multipartResolver , 否则上传文件会报400的错误!在这里栽过坑,教训!】

      1
      2
      3
      4
      5
      6
      7
      8
      <!--文件上传配置-->
      <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.编写前端页面

      1
      2
      3
      4
      <form action="/upload" enctype="multipart/form-data" method="post">
      <input type="file" name="file"/>
      <input type="submit" value="upload">
      </form>
    • 4.Controller

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      42
      43
      44
      45
      46
      47
      48
      49
      50
      51
      package com.kuang.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";

      }
      }
  3. 采用file.Transto 来保存上传的文件

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    /*

    * 采用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";
    }
  4. 文件下载

    文件下载步骤:

    1、设置 response 响应头

    2、读取文件 – InputStream

    3、写出文件 – OutputStream

    4、执行操作

    5、关闭流 (先开后关)

    代码实现:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    @RequestMapping(value="/download")
    public String downloads(HttpServletResponse response ,HttpServletRequest request) throws Exception{
    //要下载的图片地址
    String path = request.getServletContext().getRealPath("/upload");
    String fileName = "基础语法.jpg";

    //1、设置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);
    //2、 读取文件--输入流
    InputStream input=new FileInputStream(file);
    //3、 写出文件--输出流
    OutputStream out = response.getOutputStream();

    byte[] buff =new byte[1024];
    int index=0;
    //4、执行 写出操作
    while((index= input.read(buff))!= -1){
    out.write(buff, 0, index);
    out.flush();
    }
    out.close();
    input.close();
    return null;
    }
    ————————————————
    版权声明:本文为CSDN博主「南风1789」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
    原文链接:https://blog.csdn.net/southwindpass/article/details/113980739