Spring Boot 文件上传

创建项目

Spring Initializr 创建 Spring Boot 项目，模板引擎选择 Thymeleaf。

项目的 pom.xml 如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.7.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.yin</groupId>
    <artifactId>file-upload</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>file-upload</name>
    <description>Spring Boot 文件上传练习</description>

    <properties>
        <java.version>11</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.springframework.boot</groupId>
                            <artifactId>spring-boot-configuration-processor
                            </artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

编写页面

在项目 resources/templates 文件夹下创建页面 FileUpload.html。

注意：表单 method="post"，enctype="multipart/form-data"。多文件上传的 input 标签需要标注 multiple。

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>文件上传</title>
</head>
<body>
<h1>文件上传</h1>
<form method="post" action="/fileUpload" enctype="multipart/form-data">
    用户名：
    <label>
        <input type="text" name="username">
    </label>
    <br>
    单文件上传：<input type="file" name="singleFile">
    <br>
    多文件上传：<input type="file" name="multipleFiles" multiple>
    <br>
    <input type="submit" value="提交">
</form>
</body>
</html>

编写 Controller

创建 Controller 处理请求，Spring Boot 进行文件上传已经十分方便。以单文件上传为例，多文件上传基本一样，数组处理即可。

@RequestPart("singleFile") MultipartFile singleFile ：注解 @RequestPart("singleFile") 取出表单中 name="singleFile" 的 input 项，将文件封装到 MultipartFile singleFile，在方法中直接对其进行操作即可。
getOriginalFilename() 方法获取上传的文件名
getSize() 方法获取文件大小（单位byte）
transferTo() 方法可直接将文件进行保存；想自己手动进行这一操作，也可以调用其 getBytes() 或者 getInputStream() 方法。

多文件上传只需数组处理 @RequestPart("multipleFiles") MultipartFile[] multipleFiles ，在方法中利用循环逐个进行处理即可。

package com.yin.fileupload.controller;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.IOException;

/**
 * FileUploadController
 *
 * @author Yin Guiqing
 */
@Controller
public class FileUploadController {
    /**
     * 自定义文件保存路径，在 application.properties 中设置
     */
    @Value("${file.upload.path}")
    private String path;

    /**
     * 去文件上传页面
     */
    @GetMapping("/")
    public String uploadPage() {
        return "FileUpload";
    }

    /**
     * 处理文件上传请求
     */
    @ResponseBody
    @PostMapping("/fileUpload")
    public String fileUpload(@RequestParam("username") String username,
                             @RequestPart("singleFile") MultipartFile singleFile,
                             @RequestPart("multipleFiles") MultipartFile[] multipleFiles) throws IOException {
        System.out.println(username + " 上传文件");
        // 处理单文件上传
        // 文件名
        String singleFileName = singleFile.getOriginalFilename();
        // 文件大小（字节）
        long singleFileSize = singleFile.getSize();
        // 保存文件
        if (!singleFile.isEmpty()) {
            singleFile.transferTo(new File(path + singleFileName));
        }
        String msg1 = "单文件上传成功！文件名：" + singleFileName
                + "，文件大小（byte）：" + singleFileSize;
        System.out.println(msg1);

        // 处理多文件上传
        // 文件个数
        int length = multipleFiles.length;
        System.out.println("多文件上传个数：" + length);
        for (MultipartFile multipleFile : multipleFiles) {
            // 文件名
            String multipleFileName = multipleFile.getOriginalFilename();
            // 文件大小（字节）
            long multipleFileSize = multipleFile.getSize();
            // 保存文件
            if (!multipleFile.isEmpty()) {
                multipleFile.transferTo(new File(path + multipleFileName));
            }
            String msg2 = "文件上传成功！文件名：" + multipleFileName
                    + "，文件大小（byte）：" + multipleFileSize;
            System.out.println(msg2);
        }
        return "上传完毕";
    }
}