Spring开发系统时如何实现上传和下载文件

代码如下

值得注意的是上传时候不需要参数servletRequest而下载时候却需要servletResponse，这是为什么呢？

这是因为文件上传时，客户端通过 HTTP POST 请求将文件数据放在 请求体（Body） 中。Spring MVC 对上传过程进行了高度封装，开发者无需直接操作 HttpServletRequest：

• 框架自动解析：当请求的 Content-Type 为 multipart/form-data 时，Spring 会自动解析请求体，并将文件内容封装为 MultipartFile 对象。

• 简化参数绑定：通过 @RequestParam(“file”) MultipartFile file 即可直接获取文件对象，无需手动从 HttpServletRequest 中提取数据。

那为什么需要servletResponse呢？

• 因为文件内容需要直接写入响应输出流，而 Spring 的 @ResponseBody 或 ResponseEntity 适用于结构化数据（如 JSON），不适合大文件流式传输。

package com.xxx.xxxxx.controller;

import com.xxx.xxxxx.common.R;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.util.UUID;

/**
 * 文件上传和下载
 */
@RestController
@RequestMapping("/common")
@Slf4j
public class CommonController {

	// 这个在application.yml里配置
    @Value("${reggie.path}")
    private String basePath;

    /**
     * 文件上传
     * @param file
     * @return
     */
    @PostMapping("/upload")
    public httpResp<String> upload(@RequestParam("file") MultipartFile file){
        // file是一个临时文件，需要转存到指定位置，否则本次请求完成后临时文件会删除
        log.info(file.toString());

        //原始文件名
        String originalFilename = file.getOriginalFilename();//abc.jpg
        String suffix = originalFilename.substring(originalFilename.lastIndexOf("."));

        //使用UUID重新生成文件名，防止文件名称重复造成文件覆盖
        String fileName = UUID.randomUUID().toString() + suffix;//dfsdfdfd.jpg

        //创建一个目录对象
        File dir = new File(basePath);
        //判断当前目录是否存在
        if(!dir.exists()){
            //目录不存在，需要创建
            dir.mkdirs();
        }

        try {
            // 将临时文件转存到指定位置
            file.transferTo(new File(basePath + fileName));
        } catch (IOException e) {
            e.printStackTrace();
        }
        return httpResp.success(fileName);
    }

    /**
     * 文件下载
     * @param name
     * @param response
     */
    @GetMapping("/download")
    public void download(String name, HttpServletResponse response){

        try {
            //输入流，通过输入流读取文件内容
            FileInputStream fileInputStream = new FileInputStream(new File(basePath + name));

            //输出流，通过输出流将文件写回浏览器，因为我们要把文件返还回去，所以要ServletResponse
            ServletOutputStream outputStream = response.getOutputStream();

            response.setContentType("image/jpeg");

            int len = 0;
            byte[] bytes = new byte[1024];
            while ((len = fileInputStream.read(bytes)) != -1){
                outputStream.write(bytes,0,len);
                outputStream.flush();
            }

            //关闭资源
            outputStream.close();
            fileInputStream.close();
        } catch (Exception e) {
            e.printStackTrace();
        }

    }
}