文件上传在 SpringBoot 中的简洁实现

2023-12-04 20:22:03

SpringBoot 文件上传和下载指南

文件上传是网络应用程序中一个不可或缺的功能，它使我们能够将文件（图像、视频、文档等）从客户端传输到服务器。SpringBoot 是一个流行的 Java 框架，它为文件上传和下载提供了强大的功能。本指南将详细介绍如何在 SpringBoot 中轻松实现这些功能。

单文件上传

单文件上传涉及从客户端向服务器发送一个文件。要实现这一点，我们需要在控制器中创建一个端点，如下所示：

@PostMapping("/upload")
public ResponseEntity<String> uploadFile(@RequestParam("file") MultipartFile file) {
    // 处理文件上传逻辑
    return ResponseEntity.ok("文件上传成功");
}

在 HTML 表单中，使用 <input type="file"> 元素允许用户选择一个文件进行上传。当表单提交时，选定的文件将作为 MultipartFile 对象传递给控制器方法。

多文件上传

多文件上传允许用户一次上传多个文件。要实现这一点，我们需要使用 <input type="file" multiple> 元素，并在控制器中使用数组接收文件：

@PostMapping("/upload-multiple")
public ResponseEntity<String> uploadMultipleFiles(@RequestParam("files") MultipartFile[] files) {
    // 处理多文件上传逻辑
    return ResponseEntity.ok("多文件上传成功");
}

文件存储

上传文件后，我们需要将它们存储在服务器上。SpringBoot 提供了多种文件存储选项，包括：

本地文件系统： 使用 java.io.File 类将文件存储在服务器的本地磁盘上。
Amazon S3： 使用 Amazon Simple Storage Service 将文件存储在云端。
Azure Blob Storage： 使用 Microsoft Azure Blob Storage 将文件存储在云端。

文件下载

一旦文件上传成功，我们需要提供一个功能来让用户下载它们。在控制器中，我们创建一个新的端点来处理下载请求：

@GetMapping("/download/{fileName}")
public ResponseEntity<Resource> downloadFile(@PathVariable String fileName) {
    // 处理文件下载逻辑
    return ResponseEntity.ok().header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + fileName + "\"").body(new FileSystemResource(new File(fileName)));
}