文件上传 - 单文件上传 - 实现单个文件上传

Java - Web - Spring 《文件上传 - 单文件上传 - 实现单个文件上传》

在Web开发中，文件上传是一个非常常见的功能。比如用户上传头像、上传文档等场景都需要用到文件上传功能。在Spring框架中，实现单文件上传是相对简单的，下面我们将详细介绍如何在Spring项目中实现单个文件的上传。

1. 环境准备

在开始之前，我们需要确保已经搭建好了Spring项目。如果你使用的是Spring Boot，可以在pom.xml中添加以下依赖：

<dependencies>
    <!-- Spring Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- 支持文件上传 -->
    <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>
</dependencies>

2. 配置文件上传解析器

在Spring Boot中，我们不需要手动配置文件上传解析器，Spring Boot会自动帮我们配置好。但如果是传统的Spring项目，需要在配置文件中添加如下配置：

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <!-- 设置最大上传文件大小，单位为字节 -->
    <property name="maxUploadSize" value="10485760"/> 
</bean>

3. 创建前端页面

创建一个简单的HTML页面用于文件上传，命名为upload.html：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>单文件上传</title>
</head>
<body>
    <form action="/upload" method="post" enctype="multipart/form-data">
        <input type="file" name="file"/>
        <input type="submit" value="上传"/>
    </form>
</body>
</html>

需要注意的是，表单的enctype属性必须设置为multipart/form-data，这样才能支持文件上传。

4. 创建Controller处理文件上传请求

创建一个Controller类来处理文件上传请求：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.io.IOException;
@Controller
public class FileUploadController {
    @PostMapping("/upload")
    public String handleFileUpload(@RequestParam("file") MultipartFile file) {
        if (!file.isEmpty()) {
            try {
                // 获取文件的原始文件名
                String originalFilename = file.getOriginalFilename();
                // 指定文件保存的路径
                String filePath = "D:/uploads/";
                File dest = new File(filePath + originalFilename);
                // 判断目录是否存在，不存在则创建
                if (!dest.getParentFile().exists()) {
                    dest.getParentFile().mkdirs();
                }
                // 将文件保存到指定路径
                file.transferTo(dest);
                System.out.println("文件上传成功：" + originalFilename);
                return "success";
            } catch (IOException e) {
                e.printStackTrace();
                System.out.println("文件上传失败：" + e.getMessage());
                return "error";
            }
        } else {
            System.out.println("上传的文件为空");
            return "error";
        }
    }
}

在上述代码中，我们使用@RequestParam注解来接收上传的文件，MultipartFile是Spring提供的用于处理文件上传的接口。通过transferTo方法将文件保存到指定的路径。

5. 创建结果页面

创建success.html和error.html两个页面用于显示文件上传的结果：

success.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>上传成功</title>
</head>
<body>
    <h1>文件上传成功！</h1>
</body>
</html>

error.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>上传失败</title>
</head>
<body>
    <h1>文件上传失败，请重试！</h1>
</body>
</html>

6. 运行项目

启动Spring Boot项目，访问http://localhost:8080/upload.html，选择一个文件并点击上传按钮，根据上传结果会跳转到相应的页面。

总结

步骤	操作	说明
1	环境准备	添加必要的依赖
2	配置文件上传解析器	Spring Boot自动配置，传统Spring项目需手动配置
3	创建前端页面	表单的`enctype`属性必须设置为`multipart/form-data`
4	创建Controller处理请求	使用`@RequestParam`和`MultipartFile`处理文件上传
5	创建结果页面	显示文件上传的结果
6	运行项目	访问上传页面进行测试

通过以上步骤，我们就可以在Spring项目中实现单个文件的上传功能了。这个功能可以方便地应用到各种Web项目中，为用户提供文件上传的服务。