SpringMVC 文件上传和文件下载

最新推荐文章于 2023-03-18 21:21:32 发布

墨客小书虫

最新推荐文章于 2023-03-18 21:21:32 发布

阅读量281

点赞数

分类专栏：看书学习 java基础文章标签： java spring servlet

本文链接：https://blog.csdn.net/weixin_45956631/article/details/125972054

版权

java基础同时被 2 个专栏收录

13 篇文章 0 订阅

订阅专栏

看书学习

10 篇文章 0 订阅

订阅专栏

文章目录

文件上传原理

当客户端form表单的enctype属性为multipart/form-data时，浏览器就会采用二进制流的方式来处理表单数据，服务器端就会对文件上传的请求进行解析处理。Spring MVC为文件上传提供了直接的支持，这种支持是通过MultipartResolver（多部件解析器）对象实现的。MultipartResolver是一个接口对象，需要通过它的实现类CommonsMultipartResolver来完成文件上传工作。在Spring MVC中使用MultipartResolver对象非常简单，只需要在配置文件中定义MultipartResolver接口的Bean即可

搭建

依赖

<!--    文件上传-->
    <dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>1.4</version>
    </dependency>
    <dependency>
      <groupId>commons-io</groupId>
      <artifactId>commons-io</artifactId>
      <version>2.11.0</version>
    </dependency>

前端页面

<%@ page language="java" contentType="text/html; charset=UTF-8"
   pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>文件上传</title>
<script>
// 判断是否填写上传人并已选择上传文件
function check(){
    var name = document.getElementById("name").value;
    var file = document.getElementById("file").value;
    if(name==""){
        alert("填写上传人");
        return false;
    }
    if(file.length==0||file==""){
        alert("请选择上传文件");
        return false;
    }
    return true;
}
</script>
</head>
<body>
    <form action="${pageContext.request.contextPath }/fileUpload"
    method="post" enctype="multipart/form-data" οnsubmit="return check()">
   上传人：<input id="name" type="text" name="name" /><br />
   请选择文件：<input id="file" type="file" name="uploadfile" 
                                                   multiple="multiple" /><br />
             <input type="submit" value="上传" />
   </form>
</body>
</html>

配置类

<!-- 配置文件上传解析器 MultipartResolver -->
<bean id="multipartResolver" class=
        "org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <!-- 设置请求编码格式-->
    <property name="defaultEncoding" value="UTF-8" />
</bean>

控制层

两个参数文件和上传人的名字

上传到程序中的文件就是被封装在MultipartFile参数中的。org.springframework.web.multipart.MultipartFile接口中提供了获取上传文件、文件名称等方法

/**
 * 执行文件上传
 */
@RequestMapping("/fileUpload")
public String handleFormUpload(@RequestParam("name") String name,
      @RequestParam("uploadfile") List<MultipartFile> uploadfile,
      HttpServletRequest request) {
   // 判断所上传文件是否存在
   if (!uploadfile.isEmpty() && uploadfile.size() > 0) {
      //循环输出上传的文件
      for (MultipartFile file : uploadfile) {
         // 获取上传文件的原始名称
         String originalFilename = file.getOriginalFilename();
         // 设置上传文件的保存地址目录
         String dirPath ="D:\\upload\\";
         System.out.println(dirPath);
         File filePath = new File(dirPath);
         // 如果保存文件的地址不存在，就先创建目录
         if (!filePath.exists()) {
            filePath.mkdirs();
         }
         // 使用UUID重新命名上传的文件名称(上传人_uuid_原始文件名称)
         String newFilename = name+ "_"+UUID.randomUUID() + 
                                                  "_"+originalFilename;
         System.out.println(newFilename);
         try {
            // 使用MultipartFile接口的方法完成文件上传到指定位置
            file.transferTo(new File(dirPath + newFilename));
         } catch (Exception e) {
            e.printStackTrace();
                      return"error";
         }
      }
      // 跳转到成功页面
      return "success";
   }else{
      return"error";
   }
}

MultipartFile参数的其他·方法

在这里插入图片描述

文件下载

文件下载就是将文件服务器中的文件下载到本机上。

Spring MVC提供了一个ResponseEntity类型的对象，使用它可以很方便地定义返回的HttpHeaders对象和HttpStatus对象，通过对这两个对象的设置，即可完成下载文件时所需的配置信息

提前准备照片

在这里插入图片描述

搭建

前端页面

照片的名字

filename=324.jpg

<%@ page language="java" contentType="text/html; charset=UTF-8"
     pageEncoding="UTF-8"%>
<%@page import="java.net.URLEncoder"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
     "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>下载页面</title>
</head>
<body>
    <a href="${pageContext.request.contextPath }/download?filename=324.jpg">
       文件下载
   </a>
   
</body>
</html>

控制层

@RequestMapping("/download")
public ResponseEntity<byte[]> fileDownload(HttpServletRequest request,
                                           String filename) throws Exception{
    // 指定要下载的文件所在路径
    String path = request.getSession().getServletContext().getRealPath("/upload/");
    // 创建该文件对象
    File file = new File(path+File.separator+filename);
    // 设置响应头
    HttpHeaders headers = new HttpHeaders();
    // 通知浏览器以下载的方式打开文件
    headers.setContentDispositionFormData("attachment", filename);
    // 定义以流的形式下载返回文件数据
    headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
    // 使用Sring MVC框架的ResponseEntity对象封装返回下载数据
   return new ResponseEntity<byte[]>(FileUtils.readFileToByteArray(file),
                                                       headers,HttpStatus.OK);
}

分析

在fileDownload()方法中，首先根据文件路径和需要下载的文件名来创建文件对象，然后对响应头中文件下载时的打开方式以及下载方式进行了设置，最后返回ResponseEntity封装的下载结果对象。

有中文名称的文件下载

比上面多了两步，编码和转码

可以在前端页面发送请求前先对中文名进行统一编码，然后在后台控制器类中对文件名称进行相应的转码

前端

URLEncoder.encode 编码

<%@ page language="java" contentType="text/html; charset=UTF-8"
     pageEncoding="UTF-8"%>
<%@page import="java.net.URLEncoder"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
     "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>下载页面</title>
</head>
<body>
  <a href="${pageContext.request.contextPath}/download?filename=<%=
                                   URLEncoder.encode("土排.jpg","UTF-8")%>">
      中文名称文件下载
   </a>


</body>
</html>

控制层

    @RequestMapping("/download")
   public ResponseEntity<byte[]> fileDownload(HttpServletRequest request,
                                              String filename) throws Exception{
       // 指定要下载的文件所在路径
       String path = request.getSession().getServletContext().getRealPath("/upload/");
       // 创建该文件对象
       File file = new File(path+File.separator+filename);
       // 对文件名编码，防止中文文件乱码
      System.out.println("=============================前"+filename);
//    filename = new String(filename.getBytes("ISO-8859-1"), "UTF-8");
        filename = this.getFilename(request, filename);
      System.out.println("=============================后"+filename);
       // 设置响应头
       HttpHeaders headers = new HttpHeaders();
       // 通知浏览器以下载的方式打开文件   i
       headers.setContentDispositionFormData("attachment", filename);
       // 定义以流的形式下载返回文件数据
       headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);
       // 使用Sring MVC框架的ResponseEntity对象封装返回下载数据
      return new ResponseEntity<byte[]>(FileUtils.readFileToByteArray(file),
                                              headers,HttpStatus.OK);
   }
   /**
    * 根据浏览器的不同进行编码设置，返回编码后的文件名
    */
   public String getFilename(HttpServletRequest request,
                                               String filename) throws Exception {
       // IE不同版本User-Agent中出现的关键词

      System.out.println(filename);
       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中的关键字。

如果还是乱码可以对tomcat 配置UTF-8