處理SpringMVC中的文件上傳過程

更新時間：2026年05月16日 10:46:48 作者：埃澤漫筆

配置SpringMVC支持文件上傳,在在配置文件中添加支持；創(chuàng)建包含文件上傳字段的表單；在控制器中編寫處理文件上傳請求的方法,使用@RequestParam注解將上傳的文件綁定到方法參數(shù)

配置 Spring MVC 以支持文件上傳

首先，需要在 Spring 配置文件中添加對文件上傳的支持。

你可以在 Spring 的 Java 配置類或 XML 配置文件中進(jìn)行配置。

Java 配置類方式

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.multipart.commons.CommonsMultipartResolver;
@Configuration
public class AppConfig {
    @Bean
    public CommonsMultipartResolver multipartResolver() {
        CommonsMultipartResolver multipartResolver = new CommonsMultipartResolver();
        multipartResolver.setMaxUploadSize(50000000); // 設(shè)置最大上傳文件大小為 50MB
        return multipartResolver;
    }
}

XML 配置文件方式

<beans xmlns="http://www.springframework.org/schema/beans"
       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">
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <property name="maxUploadSize" value="50000000"/> <!-- 設(shè)置最大上傳文件大小為 50MB -->
    </bean>
</beans>

創(chuàng)建一個表單用于文件上傳

創(chuàng)建一個包含文件上傳字段的 HTML 表單。

注意，表單的 enctype 屬性必須設(shè)置為 multipart/form-data。

<!DOCTYPE html>
<html>
<head>
    <title>File Upload</title>
</head>
<body>
    <form method="post" action="/upload" enctype="multipart/form-data">
        <input type="file" name="file" />
        <input type="submit" value="Upload" />
    </form>
</body>
</html>

編寫控制器方法來處理文件上傳請求

在控制器中編寫處理文件上傳請求的方法。

使用 @RequestParam 注解將上傳的文件綁定到方法參數(shù)上。

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 org.springframework.web.bind.annotation.ResponseBody;
import java.io.File;
import java.io.IOException;
@Controller
public class FileUploadController {
    @PostMapping("/upload")
    @ResponseBody
    public String handleFileUpload(@RequestParam("file") MultipartFile file) {
        if (!file.isEmpty()) {
            try {
                // 獲取文件名
                String fileName = file.getOriginalFilename();
                // 將文件保存到指定路徑
                String filePath = "C:/uploads/" + fileName;
                File dest = new File(filePath);
                file.transferTo(dest);
                return "File uploaded successfully: " + fileName;
            } catch (IOException e) {
                e.printStackTrace();
                return "Failed to upload file: " + e.getMessage();
            }
        } else {
            return "Failed to upload file: File is empty.";
        }
    }
}