Spring MVC多种情况下的文件上传

一、原生 方式 上传

上传是We b 工程中很常见的功能，Spr in gMVC框架简化了文件上传的代码，我们首先使用JAVAEE原生方式上传文件来进行详细描述：

1.1 修改 web.xml 项目 版本

这里我们创建新的Spr in gMVC模块，在web.xml中将项目从2.3改为3.1，即可默认开启 el 表达式，如下图：

1.2 上传JSP页面

那这里我们需要访问一个页面来进行文件下载

&lt;%@ page contentType="text/html;charset=UTF-8" language="java" %&gt;
&lt;html&gt;
&lt;head&gt;
    &lt;title&gt;上传</title&gt;
</head&gt;
<body&gt;
    <h3>文件上传</h3>
    <%-- 上传表单的提交方式必须是post --%>
    <%-- enctype属性为multipart/from-data,意思是不对表单数据进行编码 --%>
    <form action="/fileUpload" method="post" enctype="multipart/form-data">
        <%-- 文件选择控件，类型是file，必须要有name属性 --%>
        选择文件：<input type="file" name="upload"/>
        <input type="submit" value="上传">
    </form>
</body>
</html>

1.3 引入 文件上传依赖

接下来需要分析请求体中的文件项，并将数据写入磁盘，此时需要借助文件上传工具

    <dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>1.3.1</version>
    </dependency>
    <dependency>
      <groupId>commons-io</groupId>
      <artifactId>commons-io</artifactId>
      <version>2.4</version>
    </dependency>

1.4 分析 控制器 执行 流程

编写控制器接收上传请求，控制器进行三步操作：

创建文件夹，存放上传文件。

分析请求体，找到上传文件数据。

将文件数据写入文件夹。

完整文件上传控制器代码如下：

package com.example.controller;

import com.sun.jersey.api.client.Client;
import com.sun.jersey.api.client.WebResource;
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.http.HttpServletRequest;
import java.io.File;
import java.util.List;
import java.util.UUID;

@Controller
public class UploadController {

    @RequestMapping("/fileUpload")
    public String upload(HttpServletRequest request) throws Exception{
        // 创建文件夹，存放上传文件
        // 1.设置上传文件夹的真实路径
        String realpath = request.getSession().getServletContext().getRealPath("/upload");

        System.out.println(realpath);
        // 2.判断目录是否存在，如果不存在，创建该目录
        File file = new File(realpath);
        if(!file.exists()){
            file.mkdirs();
        }

        // 分析请求体，找到上传文件数据
        // 1.创建磁盘文件工厂
        DiskFileItemFactory factory = new DiskFileItemFactory();
        // 2.创建上传数据分析器对象
        ServletFileUpload servletFileUpload = new ServletFileUpload(factory);
        // 3.利用分析器对象解析请求体，返回所有数据项
        List<FileItem> fileItems = servletFileUpload.parseRequest(request);
        // 遍历所有数据，找到文件项（非表单项）
        for(FileItem fileItem:fileItems){
            if(!fileItem.isFormField()){
                // 将文件数据写进文件夹
                // 1.获取文件名
                String name = fileItem.getName();
                // 2.将文件写入磁盘
                fileItem.write(new File(file,name));
                System.out.println(file.getAbsoluteFile());
                // 3.删除内存中的临时文件
                fileItem.delete();
            }
        }
        return "index";
    }
}

文件成功下载后跳转到默认页面。

1.5 测试 结果

访问路径：http://localhost:8080/upload.jsp

点击选择文件，选择要上传的文件，然后点击上传。

OK，可以看得到web app 目录下面多了一个文件夹upload，并且里面有我们刚刚上传的文件。可以看得出来用原生的方式来完成文件上传是比较麻烦的，接下来我们看一下用Spring MVC方式如何来进行文件上传

二、Spring MVC 方式上传

SpringMVC使用框架提供的文件解析器对象，可以直接将请求体中的文件数据转为MultipartFile对象，从而省略原生上传中分析请求体的步骤。

2.1 配置文件 解析器

<!-- 文件解析器对象，id名称必须是multipartResolver -->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <!-- 支持一次上传文件的总容量。单位：字节100M = 100*1024*1024 -->
        <property name="maxUploadSize" value="104857600"/>
        <!-- 文件名的编码方式 -->
        <property name="defaultEncoding" value="utf-8"/>
    </bean>

2.2 创建JSP表单

upload2,.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>上传</title>
</head>
<body>
<h3>文件上传</h3>
<%-- 上传表单的提交方式必须是post --%>
<%-- enctype属性为multipart/from-data,意思是不对表单数据进行编码 --%>
<form action="/fileUpload2" method="post" enctype="multipart/form-data">
    <%-- 文件选择控件，类型是file，必须要有name属性 --%>
        选择文件:<input type="file" name="file">
        <input type="submit" value="上传">
</form>
</body>
</html>

其实这个JSP和上面那个没什么区别，只是响应处理的路径不同，为了避免重复开关 tomcat，因为就多编写了一个表单。

2.3 控制器 方法

// MultipartFile参数名必须和JSP文件空间的name属性一致
    @RequestMapping("/fileUpload2")
    public String upload2(MultipartFile file,HttpServletRequest request) throws Exception{
        // 创建文件夹，存放上传文件
        String realpath = request.getSession().getServletContext().getRealPath("/upload");
        File dir = new File(realpath);
        if(!dir.exists()){
            dir.mkdirs();
        }

        // 将上传的数据写到文件夹的文件中
        // 1.拿到上传的文件名
        String filename = file.getOriginalFilename();
        filename = UUID.randomUUID()+"_"+filename;
        // 2.创建空文件
        File newFile = new File(dir,filename);
        // 3.将数据写入空文件中
        file.transferTo(newFile);
        return "index";
    }

Ok，可以看到这个比上面那个简单许多，只需要参数名和表单的name属性一致便可以自动匹配。

2.4 测试 结果

OK，访问路径：http://localhost:8080/upload2.jsp

看到如下图，我们是成功上传了呢

三、上传多文件

SpringMVC支持一次性上传多个文件，写法如下：

3.1 JSP页面

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>上传</title>
</head>
<body>
<h3>文件上传</h3>
<%-- 上传表单的提交方式必须是post --%>
<%-- enctype属性为multipart/from-data,意思是不对表单数据进行编码 --%>
<form action="/fileUpload3" method="post" enctype="multipart/form-data">
    <%-- 文件选择控件，类型是file，必须要有name属性 --%>
    用户名：<input name="username"/><br/>
    文件1：<input type="file" name="files"><br/>
    文件2：<input type="file" name="files"><br/>
    <input type="submit" value="上传">
</form>
</body>
</html>

3.2 控制器 方法

// 处理多文件上传，参数类型为MultipartFile数组参数名和JSP文件控件的name属性一致
    @RequestMapping("/fileUpload3")
    public String upload3(MultipartFile files[],String username,HttpServletRequest request) throws Exception{
        System.out.println(username);
        // 1.设置上传文件保存的文件夹
        String realPath = request.getSession().getServletContext().getRealPath("/upload/files");
        File dir = new File(realPath);
        if(!dir.exists()){
            dir.mkdirs();
        }
        // 2.遍历数组，将上传文件保存到文件夹
        for(MultipartFile file:files){
            String filename = file.getOriginalFilename();
            filename = UUID.randomUUID()+"_" +filename;
            File newFile = new File(dir,filename);
            file.transferTo(newFile);
        }
        return "index";
    }

这里我们可以知道，方法参数名改一下类型即可，并且表单的文件name必须要一致，上传后的文件放在upload文件夹子文件夹files里。

3.3 测试结果

OK，如下图，我们是可以成功添加了files文件夹，并且里面也是有文件的

往期专栏&文章 相关导读

大家如果对于本期内容有什么不了解的话也可以去看看往期的内容，下面列出了博主往期精心制作的Maven，Mybatis等专栏系列文章，走过路过不要错过哎！如果对您有所帮助的话就点点赞，收藏一下啪。其中Spring专栏有些正在更，所以无法查看，但是当博主全部更完之后就可以看啦。

1. Maven系列 专栏 文章

Maven系列专栏	Maven工程开发
	Maven聚合开发【实例详解—5555字】

2. Mybatis系列专栏文章

Mybatis系列专栏	MyBatis入门配置
	Mybatis入门案例【超详细】
	MyBatis配置文件 —— 相关标签详解
	Mybatis模糊查询——三种定义参数方法和聚合查询、主键回填
	Mybatis动态SQL查询 –（附实战案例–8888个字–88质量分）
	Mybatis分页查询——四种传参方式
	Mybatis一级缓存和二级缓存（带测试方法）
	Mybatis分解式查询
	Mybatis关联查询【附实战案例】
	MyBatis注解开发—实现增删查改和动态SQL
	MyBatis注解开发—实现自定义映射关系和关联查询

3. Spring系列专栏文章

Spring系列专栏	Spring IOC 入门简介【自定义容器实例】
	IOC使用Spring实现附实例详解
	Spring IOC之对象的创建方式、策略及销毁时机和生命周期且获取方式
	Spring DI简介及依赖注入方式和依赖注入类型
	Spring IOC相关注解运用——上篇
	Spring IOC相关注解运用——下篇
	Spring AOP简介及相关案例
	注解、原生Spring、SchemaBased三种方式实现AOP【附详细案例】
	Spring事务简介及相关案例
	Spring 事务管理方案和事务管理器及事务控制的API
	Spring 事务的相关配置、传播行为、隔离级别及注解配置声明式事务

4. Spring MVC系列专栏文章

SpringMVC系列专栏	Spring MVC简介附入门案例
	Spring MVC各种参数获取及获取方式自定义类型转换器和编码过滤器
	Spring MVC获取参数和自定义参数类型转换器及编码过滤器
	Spring MVC处理响应附案例详解
	Spring MVC相关注解运用 —— 上篇
	Spring MVC相关注解运用 —— 中篇
	Spring MVC相关注解运用 —— 下篇
	Spring MVC多种情况下的文件上传
	Spring MVC异步上传、跨服务器上传和文件下载
	Spring MVC异常处理【单个控制异常处理器、全局异常处理器、自定义异常处理器】
	Spring MVC拦截器和跨域请求
	SSM整合案例【C站讲解最详细流程的案例】