升级 Spring Boot 3 配置讲解 —— 支持断点传输的文件上传和下载功能

学会这款 🔥全新设计的 Java 脚手架 ，从此面试不再怕！

在现代 Web 应用中，文件上传和下载是非常常见的需求。然而，当文件较大时，传统的上传下载方式可能会遇到网络不稳定或传输中断的问题。为了解决这些问题，断点传输（Resumable Upload/Download）成为了一个重要的技术手段。Spring Boot 3 提供了更强大的支持，使得实现断点传输变得更加简单。

本文将详细介绍如何在 Spring Boot 3 中实现支持断点传输的文件上传和下载功能，并通过代码示例帮助你快速上手。

1. 什么是断点传输？

断点传输是指在文件传输过程中，如果传输中断（如网络故障或用户手动暂停），可以从断点处继续传输，而不需要重新开始。这种技术对于大文件传输尤为重要，因为它可以显著减少重复传输的时间和带宽消耗。

• 断点上传：客户端可以将文件分成多个块（Chunk），分批次上传，服务器端根据上传的块信息进行合并。
• 断点下载：客户端可以请求文件的某一部分，服务器端根据请求的范围返回对应的文件内容。

2. 环境准备

在开始之前，确保你已经具备以下环境：

• JDK 17 或更高版本（Spring Boot 3 要求的最低 JDK 版本）
• Maven 或 Gradle 构建工具
• Spring Boot 3.x

在 pom.xml 中添加以下依赖：

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

3. 实现断点上传

3.1 配置文件上传限制

在 application.properties 中配置文件上传的限制：

# 设置单个文件的最大大小
spring.servlet.multipart.max-file-size=1GB

# 设置总上传文件的最大大小
spring.servlet.multipart.max-request-size=1GB

3.2 实现断点上传接口

为了实现断点上传，我们需要记录每个文件的上传进度。以下是一个简单的实现：

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;
import java.io.RandomAccessFile;
import java.util.HashMap;
import java.util.Map;
import java.util.UUID;

@Controller
public class ResumableUploadController {
   
   

    // 保存文件块的临时目录
    private static final String UPLOAD_DIR = "uploads/";

    // 用于记录文件上传进度的缓存
    private final Map<String, Long> uploadProgressMap = new HashMap<>();

    @PostMapping("/upload")
    @ResponseBody
    public String handleChunkUpload