当前位置： 首页 > news >正文

springboot文件上传下载

news 2025/6/1 10:32:03

基于ResponseEntity的下载响应

SpringBoot中，ResponseEntity类型可以精确控制HTTP响应，为文件下载提供完善的HTTP头信息。

@RestController
@RequestMapping("/api/download")
public class FileDownloadController {@GetMapping("/file/{fileName:.+}")public ResponseEntity<byte[]> downloadFile(@PathVariable String fileName) {try {Path filePath = Paths.get("uploads/" + fileName);byte[] data = Files.readAllBytes(filePath);HttpHeaders headers = new HttpHeaders();headers.setContentDisposition(ContentDisposition.attachment().filename(fileName, StandardCharsets.UTF_8).build());headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);headers.setContentLength(data.length);return new ResponseEntity<>(data, headers, HttpStatus.OK);} catch (IOException e) {return ResponseEntity.notFound().build();}}@GetMapping("/dynamic-pdf")public ResponseEntity<byte[]> generatePdf() {// 假设这里生成了PDF文件的字节数组byte[] pdfContent = generatePdfService.createPdf();HttpHeaders headers = new HttpHeaders();headers.setContentDisposition(ContentDisposition.attachment().filename("generated-report.pdf").build());headers.setContentType(MediaType.APPLICATION_PDF);return new ResponseEntity<>(pdfContent, headers, HttpStatus.OK);}
}

优势

  • • 完全控制HTTP响应和头信息

  • • 适合各种资源类型的下载

  • • 支持动态生成的文件下载

适用场景

  • • 需要精确控制HTTP响应的场景

  • • 动态生成的文件下载

  • • 自定义缓存策略的文件服务

 基于Servlet的原生文件操作

在某些情况下，可能需要使用原生Servlet API进行更底层的文件操作。

@WebServlet("/servlet/download")
public class FileDownloadServlet extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {String fileName = request.getParameter("file");if (fileName == null || fileName.isEmpty()) {response.sendError(HttpServletResponse.SC_BAD_REQUEST);return;}File file = new File("uploads/" + fileName);if (!file.exists()) {response.sendError(HttpServletResponse.SC_NOT_FOUND);return;}// 设置响应头response.setContentType("application/octet-stream");response.setHeader("Content-Disposition", "attachment; filename="" + fileName + """);response.setContentLength((int) file.length());// 写入文件内容try (FileInputStream input = new FileInputStream(file);ServletOutputStream output = response.getOutputStream()) {byte[] buffer = new byte[4096];int bytesRead;while ((bytesRead = input.read(buffer)) != -1) {output.write(buffer, 0, bytesRead);}}}
}

要在SpringBoot中启用Servlet：

@SpringBootApplication
@ServletComponentScan  // 扫描Servlet组件
public class Application {public static void main(String[] args) {SpringApplication.run(Application.class, args);}
}

优势

  • • 对文件流操作有最大的控制权

  • • 可以实现渐进式下载和流式处理

  • • 对内存使用更加高效

适用场景

  • • 大文件处理

  • • 需要细粒度控制IO操作

  • • 与遗留Servlet系统集成

云存储服务SDK集成

对于生产环境，将文件存储在专业的存储服务中通常是更好的选择，如AWS S3、阿里云OSS、七牛云等。

<dependency><groupId>com.aliyun.oss</groupId><artifactId>aliyun-sdk-oss</artifactId><version>3.15.1</version>
</dependency>
@Configuration
public class OssConfig {@Value("${aliyun.oss.endpoint}")private String endpoint;@Value("${aliyun.oss.accessKeyId}")private String accessKeyId;@Value("${aliyun.oss.accessKeySecret}")private String accessKeySecret;@Value("${aliyun.oss.bucketName}")private String bucketName;@Beanpublic OSS ossClient() {return new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);}@Beanpublic String bucketName() {return bucketName;}
}
@RestController
@RequestMapping("/api/oss")
public class OssFileController {@Autowiredprivate OSS ossClient;@Value("${aliyun.oss.bucketName}")private String bucketName;@PostMapping("/upload")public String uploadToOss(@RequestParam("file") MultipartFile file) {if (file.isEmpty()) {return "请选择文件";}try {String fileName = UUID.randomUUID().toString() + "-" + file.getOriginalFilename();// 上传文件流ossClient.putObject(bucketName, fileName, file.getInputStream());// 生成访问URLDate expiration = new Date(System.currentTimeMillis() + 3600 * 1000);URL url = ossClient.generatePresignedUrl(bucketName, fileName, expiration);return "文件上传成功，访问URL: " + url.toString();} catch (Exception e) {e.printStackTrace();return "文件上传失败: " + e.getMessage();}}@GetMapping("/download")public ResponseEntity<byte[]> downloadFromOss(@RequestParam("key") String objectKey) {try {// 获取文件OSSObject ossObject = ossClient.getObject(bucketName, objectKey);// 读取文件内容try (InputStream is = ossObject.getObjectContent()) {byte[] content = IOUtils.toByteArray(is);HttpHeaders headers = new HttpHeaders();headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);headers.setContentDisposition(ContentDisposition.attachment().filename(objectKey).build());return new ResponseEntity<>(content, headers, HttpStatus.OK);}} catch (Exception e) {e.printStackTrace();return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).build();}}
}

 Spring Resource抽象 - 统一资源访问

Spring的Resource抽象提供了对不同来源资源的统一访问方式，非常适合文件下载场景。

@RestController
@RequestMapping("/api/resources")
public class ResourceDownloadController {@GetMapping("/download/{fileName:.+}")public ResponseEntity<Resource> downloadFile(@PathVariable String fileName) {try {// 创建文件资源Path filePath = Paths.get("uploads/" + fileName);Resource resource = new UrlResource(filePath.toUri());// 检查资源是否存在if (resource.exists()) {return ResponseEntity.ok().header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename="" + resource.getFilename() + """).contentType(MediaType.APPLICATION_OCTET_STREAM).body(resource);} else {return ResponseEntity.notFound().build();}} catch (Exception e) {return ResponseEntity.internalServerError().build();}}
}

优势

  • • 提供统一的资源抽象，易于切换资源来源

  • • 与Spring生态系统无缝集成

  • • 支持多种协议和位置的资源

适用场景

  • • 需要从多种来源提供下载的场景

  • • RESTful API文件下载

  • • 动态生成的资源下载

 Apache Commons FileUpload - 灵活的文件上传库

虽然SpringBoot内部已集成文件上传功能，但在某些场景下，可能需要Apache Commons FileUpload提供的更多高级特性。

<dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.5</version>
</dependency>
@Bean
public CommonsMultipartResolver multipartResolver() {CommonsMultipartResolver resolver = new CommonsMultipartResolver();resolver.setDefaultEncoding("UTF-8");resolver.setMaxUploadSize(10485760); // 10MBresolver.setMaxUploadSizePerFile(2097152); // 2MBreturn resolver;
}
@RestController
@RequestMapping("/api/commons")
public class CommonsFileUploadController {@PostMapping("/upload")public String handleFileUpload(HttpServletRequest request) throws Exception {// 判断是否包含文件上传boolean isMultipart = ServletFileUpload.isMultipartContent(request);if (!isMultipart) {return "不是有效的文件上传请求";}// 创建上传器DiskFileItemFactory factory = new DiskFileItemFactory();ServletFileUpload upload = new ServletFileUpload(factory);// 解析请求List<FileItem> items = upload.parseRequest(request);for (FileItem item : items) {if (!item.isFormField()) {// 处理文件项String fileName = FilenameUtils.getName(item.getName());File uploadedFile = new File("uploads/" + fileName);item.write(uploadedFile);return "文件上传成功: " + fileName;}}return "未找到要上传的文件";}
}

优势

  • • 提供更细粒度的控制

  • • 支持文件上传进度监控

  • • 可自定义文件存储策略

适用场景

  • • 需要对上传过程进行细粒度控制

  • • 大文件上传并监控进度

  • • 遗留系统集成

http://www.xdnf.cn/news/726571.html

相关文章：

  • 《系统集成项目管理工程师（第三版）》高效学习方法
  • leetcode108.将有序数组转换为二叉搜索树：递归切分中点构建平衡树的智慧
  • 传输层核心技术解析
  • HAProxy 可观测性最佳实践
  • 数据库查询性能优化：深入理解与应用物化视图
  • 设计学生管理系统的数据库
  • PostIn V1.1.2版本发布，新增接口评审功能，提升接口质量与合理性
  • 2025陕西省赛补题
  • Golang持续集成与自动化测试和部署
  • Go语言接口：灵活多态的核心机制
  • 马尔可夫链模型解析—24小时政策过山车，黄金拉升80美元V型反转路径
  • 前端antd，后端fastapi，解决文件上传
  • 【二维数组】
  • 【航天远景 MapMatrix 精品教程】08 Pix4d空三成果导入MapMatrix
  • Ubuntu 下同名文件替换后编译链接到旧内容的现象分析
  • Java String的使用续 -- StringBuilder类和StringBuffer
  • Linux（9）——进程（控制篇——下）
  • 架构分享｜三层存储架构加速云端大模型推理
  • C与C++相互调用
  • LearnOpenGL-笔记-其十
  • 解决RAGFlow（v0.19.0）有部分PDF无法解析成功的问题。
  • JNI开发流程
  • Ubuntu 桌面版忘记账户密码的重置方法
  • BaseTypeHandler用法-笔记
  • 【Linux 学习计划】-- 进程状态 | 进程运行、阻塞和挂起的本质 | 并行、并发与进程切换 | 进程优先级
  • Flink2.0及Flink-operater在K8S上部署
  • 基于51单片机的音乐盒键盘演奏proteus仿真
  • git查看commit属于那个tag
  • LangChain完全指南：从入门到精通，打造AI应用开发新范式
  • lua的笔记记录