SpringMVC的单文件上传

文件上传的具备三要素

MultipartFile的介绍

编写代码

代码运行过程

5.使用uuid修改文件名字，防止文件名字重复

6.上传到服务器

7.返回成功页面

SpringMVC当中的文件上传也属于客户端把数据传送到服务器。

文件上传的具备三要素

表单项type

post请求方式

多部分表单

MultipartFile的介绍

我们实现文件上传时使用到了MultipartFile，它是 Spring Framework 提供的一个接口，用于处理 HTTP 请求中的文件上传。它是 org.springframework.web.multipart 包的一部分。它的主要用途是接收客户端上传的文件，获取文件信息（名称、大小、类型等），将文件保存到服务器或处理文件内容等等。

编写代码

首先提供Maven依赖

XML 复制代码

<dependencies>
      <dependency>
          <groupId>org.springframework</groupId>
          <artifactId>spring-context</artifactId>
          <version>5.2.3.RELEASE</version>
      </dependency>
      <dependency>
          <groupId>org.springframework</groupId>
          <artifactId>spring-web</artifactId>
          <version>5.2.3.RELEASE</version>
      </dependency>
      <dependency>
          <groupId>org.springframework</groupId>
          <artifactId>spring-webmvc</artifactId>
          <version>5.2.3.RELEASE</version>
      </dependency>
      <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>
      <dependency>
          <groupId>javax.servlet</groupId>
          <artifactId>servlet-api</artifactId>
          <version>2.5</version>
      </dependency>
      <dependency>
          <groupId>javax.servlet</groupId>
          <artifactId>jsp-api</artifactId>
          <version>2.0</version>
      </dependency>
        <dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <version>3.8.1</version>
          <scope>test</scope>
        </dependency>
</dependencies>

springmvc.xml配置文件

XML 复制代码

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">

<!--    配置扫描包-->
    <context:component-scan base-package="com.qcby"/>

<!--    配置视图解析器-->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

<!--    配置文件上传的解析器组件-->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--        设置上传文件的总大小 8M-->
        <property name="maxUploadSize" value="8388608"/>
        <property name="defaultEncoding" value="UTF-8"/>
    </bean>

<!--    开启注解-->
    <mvc:annotation-driven/>
</beans>

web.xml配置文件：

XML 复制代码

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
  <display-name>Archetype Created Web Application</display-name>

  <!--配置前端控制器-->
  <servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!--加载springmvc.xml配置文件，配置的是Spring配置-->
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!--配置启动加载-->
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

  <!-- 配置字符编码过滤器 -->
  <filter>
    <filter-name>characterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
      <param-name>encoding</param-name>
      <param-value>UTF-8</param-value>
    </init-param>
    <init-param>
      <param-name>forceEncoding</param-name>
      <param-value>true</param-value>
    </init-param>
  </filter>
  <filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

</web-app>

jsp页面：

html 复制代码

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>文件上传</title>
</head>
<body>

<h3>文件上传</h3>

<form action="/upload" method="post" enctype="multipart/form-data">
    选择文件：<input type="file" name="upload" /><br/>
    <input type="submit" value="上传" />
</form>

</body>
</html>

controller：

java 复制代码

package com.qcby.controller;


import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.multipart.MultipartFile;

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

/**
 * 文件上传前端控制器
 */
@Controller
public class UploadController {

    @RequestMapping("/upload")
    public String upload(MultipartFile upload, HttpServletRequest request) throws Exception{
        //把文件上传到哪个位置
        String realPath = request.getSession().getServletContext().getRealPath("/uploads");
        //创建文件夹
        File file = new File(realPath);
        if(!file.exists()){
            file.mkdirs();
        }

        //获取上传的文件的名称
        String fileName = upload.getOriginalFilename();
        //修改成唯一的值
        String uuid = UUID.randomUUID().toString().replace("-","").toUpperCase();

        //唯一的值
        fileName = uuid+"_"+fileName;
        System.out.println("文件的名称："+fileName);

        upload.transferTo(new File(file,fileName));

        return  "suc";
    }


}

代码运行过程

前端页面：

首先点击选择文件：

选择好图片之后：

点击上传：

1.接收参数

后端接口会接收到这个文件，参数名称为upload，Spring MVC会自动将上传的文件绑定到这个参数

2.获取路径

获取服务器上 /uploads 目录的真实物理路径

java 复制代码

String realPath = request.getSession().getServletContext().getRealPath("/uploads")

request：HttpServletRequest 对象

.getSession()：获取当前会话(Session)

.getServletContext()：获取 Servlet 上下文（Application 范围）

.getRealPath("/uploads"):返回了 Web应用在服务器上的部署路径，参数/uploads是在项目部署路径的下一层再创建一个/uploads文件夹

我的realPath:

复制代码

D:\IdeaProjects\SpringMVCFile\target\SpringMVCFile\uploads

因为Idea使用的是工件部署模式，它先将项目编译到 target 目录，从 target 目录运行 Web 应用，

所以getRealPath() 返回的就是 target 中的路径。

3.创建目录对象

java 复制代码

File file = new File(realPath);

通过File当中的构造器初始化目录对象，传入了路径参数realPath：

java 复制代码

    public File(String pathname) {
        if (pathname == null) {
            throw new NullPointerException();
        }
        this.path = fs.normalize(pathname);
        this.prefixLength = fs.prefixLength(this.path);
    }

如果该路径不存在，就创建它：

java 复制代码

        if(!file.exists()){
            file.mkdirs();
        }

4.获取上传文件的文件名称

java 复制代码

String fileName = upload.getOriginalFilename();

5.使用uuid修改文件名字，防止文件名字重复

java 复制代码

String uuid = UUID.randomUUID().toString().replace("-","").toUpperCase();
fileName = uuid+"_"+fileName;

我的文件名称：

uuid的作用：生成一个全球唯一的标识符作为文件名前缀

方法解释：

UUID.randomUUID()：生成随机UUID，如 550e8400-e29b-41d4-a716-446655440000

.toString()：转换为字符串

.replace("-","")：移除连字符 → 550e8400e29b41d4a716446655440000

.toUpperCase()：转换为大写 → 550E8400E29B41D4A716446655440000

为什么要用UUID？

避免文件名冲突（多人上传同名文件）

提高安全性（无法猜测文件名）

防止文件名覆盖

6.上传到服务器

java 复制代码

upload.transferTo(new File(file,fileName));

new File(file, fileName)：创建 File 对象

file：目录对象（/uploads）

fileName：新文件名（UUID_原始文件名）

结果：/uploads/UUID_原始文件名

upload.transferTo(File dest)：将上传的文件内容写入目标文件

7.返回成功页面

查看目标路径：

文件上传成功