Java实战：Spring Boot 实现文件上传下载功能

本文将介绍如何在 Spring Boot 中实现文件上传和下载功能，包括原理分析、具体实现以及示例代码。通过本文，读者可以了解到 Spring Boot 文件上传下载的基本概念、实现方式以及如何在实际项目中应用。

一、背景

在 Web 开发中，文件上传和下载功能是非常常见的。例如，用户头像上传、文档下载等。Spring Boot 作为一种流行的 Java Web 开发框架，提供了便捷的文件上传和下载功能。本文将介绍如何在 Spring Boot 中实现文件上传和下载功能。

二、原理分析

1. 文件上传
文件上传主要依赖于 multipart/form-data 类型的 HTTP 请求。在客户端，用户选择文件并提交表单，浏览器会将表单数据和文件封装成一个 multipart/form-data 类型的请求发送到服务器。在服务器端，Spring Boot 会自动解析这个请求，并将文件数据存储在临时目录中。
2. 文件下载
文件下载相对简单，主要是服务器端读取文件数据，并返回给客户端。在 Spring Boot 中，我们可以通过 ResponseEntity 或 HttpServletResponse 对象来实现文件下载功能。

三、具体实现

1. 文件上传
（1）添加依赖
首先，在项目的 pom.xml 文件中添加 Spring Boot 的 Web 依赖。

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

（2）配置文件存储路径
在 application.properties 或 application.yml 文件中，可以配置文件存储的路径。

# 文件存储路径
file.upload.dir=/Users/username/uploads

（3）实现文件上传接口
创建一个 FileController 类，并添加一个文件上传的方法。

@RestController
public class FileController {
    @Value("${file.upload.dir}")
    private String uploadDir;
    @PostMapping("/upload")
    public String uploadFile(@RequestParam("file") MultipartFile file) {
        try {
            // 获取文件名
            String fileName = file.getOriginalFilename();
            // 创建文件对象
            File dest = new File(uploadDir + "/" + fileName);
            // 存储文件
            file.transferTo(dest);
            return "文件上传成功";
        } catch (IOException e) {
            e.printStackTrace();
        }
        return "文件上传失败";
    }
}

2. 文件下载
（1）实现文件下载接口
在 FileController 类中，添加一个文件下载的方法。

@GetMapping("/download")
public ResponseEntity<byte[]> downloadFile(@RequestParam("fileName") String fileName) {
    try {
        // 创建文件对象
        File file = new File(uploadDir + "/" + fileName);
        // 创建输入流
        InputStream in = new FileInputStream(file);
        // 创建字节数组
        byte[] body = new byte[in.available()];
        // 读取字节数组
        in.read(body);
        // 关闭输入流
        in.close();
        // 设置 HTTP 头信息
        HttpHeaders headers = new HttpHeaders();
        headers.add("Content-Disposition", "attachment; filename=" + file.getName());
        // 返回 ResponseEntity 对象
        return new ResponseEntity<>(body, headers, HttpStatus.OK);
    } catch (IOException e) {
        e.printStackTrace();
    }
    return new ResponseEntity<>(HttpStatus.INTERNAL_SERVER_ERROR);
}

四、测试文件上传和下载功能

1. 启动 Spring Boot 应用

@SpringBootApplication
public class FileUploadDownloadApplication {
    public static void main(String[] args) {
        SpringApplication.run(FileUploadDownloadApplication.class, args);
    }
}

2. 使用 Postman 或其他工具测试文件上传和下载接口
（1）文件上传
选择一个文件，通过 POST 请求发送到 /upload 接口。如果文件上传成功，将返回 “文件上传成功”。
（2）文件下载
通过 GET 请求访问 /download 接口，并在请求参数中提供文件名。如果文件下载成功，浏览器将自动下载该文件。

五、进阶使用

在实际项目中，我们可能需要对文件上传和下载功能进行更详细的控制，例如文件类型限制、文件大小限制、上传进度监控等。这时，我们可以使用一些第三方库，如 Apache Commons FileUpload、AjaxFileUpload 等，来实现更高级的功能。
此外，对于大型文件的上传和下载，我们可以使用分片上传和断点续传等技术，以提高上传和下载的效率。

六、总结

本文介绍了如何在 Spring Boot 中实现文件上传和下载功能，包括原理分析、具体实现以及示例代码。通过自定义 Controller 和配置文件存储路径，我们可以轻松地实现文件上传和下载功能。此外，Spring Boot 还支持更高级的文件处理功能，如文件类型限制、文件大小限制等。在实际项目中，我们可以根据需求选择合适的功能，以提高开发效率。