SpringMVC学习 && 文件上传和下载

在2003年，Apache Software Foundation发布了开源的Commons FileUpload组件，很快成为Servlet/JSP程序员上传文件的最佳选择。Servlet3.0规范已经提供方法来处理文件上传，但这种上传需要在Servlet中完成，SpringMVC则进行了简单的封装。

SpringMVC使用FileUpload技术实现了一个MultipartResolver实现类CommonMultipartResolver进行文件上传，MultipartResolver是即插即用的

• CommonsMultipartFile 的 常用方法：
  • String getOriginalFilename()：获取上传文件的原名
  • InputStream getInputStream()：获取文件流
  • void transferTo(File dest)：将上传文件保存到一个目录文件中
     

文件上传实现：

1. 导入文件上传所需要的jar包

<!--文件上传-->
<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. 在applicationContext.xml中配置multipartResolver

SpringMVC可以很好地支持文件上传，但是SpringMVC上下文中默认没有装配MultipartPart，因此默认情况下不能处理文件上传工作。如果想使用此功能，需在上下文中配置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>

3. 编写前端页面

注意：如果需要上传文件的话，必须将表单的method设置为POST，并将enctype设置为multipart/form-data。只有在这样的情况下，浏览器才会把用户选择的文件以二进制数据发送给服务器

表单中enctype属性介绍：

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

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

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

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

4. 编写Controller

@Controller
public class FileController {
    //@RequestParam("file") 将name=file控件得到的文件封装成CommonsMultipartFile 对象
    //批量上传CommonsMultipartFile则为数组即可
    @RequestMapping("/upload")
    public String fileUpload(@RequestParam("file") CommonsMultipartFile file , HttpServletRequest request) throws IOException {

        //获取文件名
        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";
    }
}

 

文件上传保存实现：

4. 修改文件上传步骤4

@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";
}

5. 修改表单提交路径
6. 启动测试：

 
下载文件步骤：

1. 设置response响应头
2. 使用InputStream读取文件
3. 使用OutputStream写出文件
4. 执行操作
5. 关闭流，要注意先打开的后关闭

下载文件实现：

1. 编写Controller

注意：要使用正确的文件路径和文件名，记得加后缀名

@RequestMapping(value="/download")
public String downloads(HttpServletResponse response , HttpServletRequest request) throws Exception{
    //要下载的图片路径和名称
    String  path = request.getServletContext().getRealPath("/upload");
    String  fileName = "TIM截图20190430231748.png";

    //1、设置response 响应头
    
    //设置页面不缓存,清空buffer
    response.reset(); 
    //设置字符编码
    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();
    }
    //5、关闭流
    out.close();
    input.close();
    return null;
}

2. 编写前端跳转链接

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

3. 启动测试