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 依赖。

    org.springframework.boot    spring-boot-starter-web

（2）配置文件存储路径

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

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

（3）实现文件上传接口

创建一个 FileController 类，并添加一个文件上传的方法。

@RestControllerpublic 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 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 应用

@SpringBootApplicationpublic 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 还支持更高级的文件处理功能，如文件类型限制、文件大小限制等。在实际项目中，我们可以根据需求选择合适的功能，以提高开发效率。