当前位置：首页 > news >正文

MultipartFile

news 2025/9/12 10:52:44

文件的处理一般都是分为两步，第一步就是文件上传到指定文件夹，第二步是对文件进行处理。

这第一步的文件上传，后端就需要用到spring提供的接口MultipartFile 来进行处理，通过接口的方法transferTo(File dest)对文件进行上传。

MultipartFile 是 Spring 框架中用于处理文件上传的一个接口。它提供了多种方法来操作上传的文件，包括获取文件名、文件大小、文件内容类型、将文件保存到磁盘等。以下是对 MultipartFile 的详细介绍：

一、`MultipartFile` 的主要方法

方法名称	返回类型	描述
`getOriginalFilename()`	`String`	获取上传文件的原始文件名
`getSize()`	`long`	获取文件的大小（字节）
`getContentType()`	`String`	获取文件的内容类型（MIME类型）
`getInputStream()`	`InputStream`	获取文件的输入流，用于读取文件内容
`transferTo(File dest)`	`void`	将上传的文件保存到指定路径

获取文件

String getOriginalFilename();

返回上传文件的原始文件名。

示例

MultipartFile file = ...; // 获取上传的文件
String fileName = file.getOriginalFilename();
System.out.println("文件名：" + fileName);

获取文件大小

long getSize();

返回文件的大小，单位是字节。

示例

long fileSize = file.getSize();
System.out.println("文件大小：" + fileSize + " 字节");

获取文件内容类

String getContentType();

返回文件的MIME类型，如image/jpeg、text/plain等。

示例

String contentType = file.getContentType();
System.out.println("文件类型：" + contentType);

获取文件的输入流

InputStream getInputStream() throws IOException;

返回文件的输入流，可以用于读取文件内容。

示例

InputStream inputStream = file.getInputStream();
// 使用输入流读取文件内容

将文件保存到磁盘(最重要的方法)

将上传的文件保存到指定的路径。

示例

File destFile = new File("D:/uploads/" + file.getOriginalFilename());
file.transferTo(destFile);
System.out.println("文件已保存到：" + destFile.getAbsolutePath());

void transferTo(File dest) throws IOException, IllegalStateException;

二、使用 `MultipartFile` 处理文件上传

以下是一个完整的示例，展示如何在Spring Boot应用中使用 MultipartFile 处理文件上传。

1. 添加依赖

在 pom.xml 文件中添加 Spring Boot Web 依赖：

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

2. 创建文件上传的Controller

import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;import java.io.File;
import java.io.IOException;@RestController
@RequestMapping("/upload")
public class FileUploadController {@PostMapping("/single")public String uploadSingleFile(@RequestParam("file") MultipartFile file) {if (file.isEmpty()) {return "文件为空，请选择一个文件上传！";}// 获取文件名String fileName = file.getOriginalFilename();System.out.println("文件名：" + fileName);// 获取文件大小long fileSize = file.getSize();System.out.println("文件大小：" + fileSize + " 字节");// 获取文件类型String contentType = file.getContentType();System.out.println("文件类型：" + contentType);// 保存文件到磁盘try {File destFile = new File("D:/uploads/" + fileName);file.transferTo(destFile);return "文件已成功上传到：" + destFile.getAbsolutePath();} catch (IOException | IllegalStateException e) {e.printStackTrace();return "文件上传失败：" + e.getMessage();}}
}

3. 配置文件上传的路径

在 application.properties 文件中配置文件上传的路径：

# 设置文件上传的临时存储路径
spring.servlet.multipart.location=D:/uploads

4. 测试文件上传

启动Spring Boot应用。
使用Postman或其他工具发送一个POST请求到http://localhost:8080/upload/single，在请求体中添加一个名为file的文件字段。
选择一个文件上传，查看控制台输出和文件是否成功保存到指定路径。

三、注意事项

文件大小限制
- 默认情况下，Spring Boot 对上传的文件大小有限制（通常是1MB）。如果需要上传较大的文件，需要在 application.properties 文件中配置文件大小限制
```
# 设置最大文件大小（例如10MB）
spring.servlet.multipart.max-file-size=10MB
# 设置最大请求大小（例如20MB）
spring.servlet.multipart.max-request-size=20MB
```
文件存储路径
- 确保指定的文件存储路径存在，否则可能会抛出异常。如果路径不存在，可以在代码中创建路径
```
File uploadDir = new File("D:/uploads");
if (!uploadDir.exists()) {uploadDir.mkdirs();
}
```
异常处理
- 在处理文件上传时，可能会遇到各种异常，如文件为空、文件大小超出限制等。建议在代码中进行适当的异常处理，返回友好的错误信息。