基于SpringWeb MultipartFile文件上传、下载功能

在Web开辟中，文件上传是一个常见的功能需求。Spring框架提供了MultipartFile接口，用于处理文件上传请求。MultipartFile可以代表一个多部分文件上传请求中的一个文件，提供了一系列方法用于获取文件的各种属性和内容，使得在后端处理文件上传变得非常方便。下面我们将介绍MultipartFile在Web应用中的几种常见利用场景。
1. 图片上传
在Web应用中，图片上传是一种常见的场景。用户必要上传头像、相片、证件照等图片文件，而后端必要吸收并保存这些文件。利用MultipartFile接口可以轻松地实现图片文件的吸收和处理。通过获取文件的原始文件名、内容范例、巨细等属性，我们可以实现对图片文件的有效管理和存储。比方，我们可以将图片文件保存到服务器的文件系统中，或者将其存储到云存储服务中。
2. 文件下载
除了文件上传，文件下载也是Web应用中常见的功能需求。利用MultipartFile接口，我们可以实现文件的下载功能。在服务器端，我们可以将文件作为MultipartFile对象举行处理，并通过设置响应头信息，将文件作为下载内容返回给客户端。客户端吸收到文件后，可以将其保存到本地磁盘或举行其他处理。
3. 文件编辑
在Web应用中，有时候用户必要对上传的文件举行编辑操作，比方修改文件名、修改文件内容等。利用MultipartFile接口，我们可以实现对文件的编辑功能。起首，我们可以通过MultipartFile接口获取上传的文件对象，然后对其举行相应的编辑操作。比方，我们可以修改文件的名称、修改文件的内容等。编辑完成后，我们可以将修改后的文件保存到服务器或返回给客户端。
4. 文件预览和展示
在Web应用中，有时候我们必要将上传的文件举行预览或展示。比方，在文档管理系统中，用户必要预览或下载文档文件。利用MultipartFile接口，我们可以实现文件的预览和展示功能。我们可以将文件作为MultipartFile对象举行处理，然后将其内容转换为适当的格式举行展示。比方，对于PDF文件，我们可以利用PDF阅读器插件举行展示；对于图片文件，我们可以将其直接展示在网页上。
5. 文件批量上传和处理
在实际应用中，有时候用户必要批量上传多个文件，并对这些文件举行处理。利用MultipartFile接口，我们可以实现文件的批量上传和处理功能。我们可以将多个文件作为一个多部分文件上传请求举行处理，然后对每个文件举行相应的操作。比方，我们可以将多个图片文件批量上传到服务器，并对它们举行压缩、裁剪等处理。
代码

1. package com.javagpt.back.controller;
3. import com.javagpt.application.context.UserAppContextHolder;
4. import com.javagpt.application.file.FileApplicationService;
5. import com.javagpt.application.file.FileDTO;
6. import com.javagpt.common.annotation.RespSuccess;
7. import com.javagpt.common.constant.EMConstant;
8. import io.swagger.annotations.Api;
9. import io.swagger.annotations.ApiOperation;
10. import jakarta.servlet.http.HttpServletRequest;
11. import jakarta.servlet.http.HttpServletResponse;
12. import lombok.RequiredArgsConstructor;
13. import lombok.extern.slf4j.Slf4j;
14. import org.springframework.web.bind.annotation.*;
15. import org.springframework.web.multipart.MultipartFile;
17. import java.io.IOException;
19. @Api(tags = "文件接口")
20. @Slf4j
21. @RestController
22. @RequestMapping(EMConstant.API_V1 + "/file")
23. @RespSuccess
24. @RequiredArgsConstructor
25. public class FileController {
27.     private final FileApplicationService fileApplicationService;
29.     @ApiOperation("通用文件上传")
30.     @PostMapping(value = "/uploadFile")
31.     public FileDTO uploadFile(@RequestParam("file") MultipartFile multipartFile) throws IOException {
32.         Long enterpriseId = UserAppContextHolder.getCurrentUser().getEnterpriseId();
33.         FileDTO fileDTO = fileApplicationService.saveFile(enterpriseId, multipartFile);
34.         return fileDTO;
35.     }
37.     //@PreAuthorize("hasAuthority('mp:file:download')")
38.     @ApiOperation("下载文件")
39.     @GetMapping(value = "/downloadFile")
40.     public void download(@RequestParam(value = "id") Long id, HttpServletResponse response) throws IOException {
41.         fileApplicationService.downloadFile(response, id, UserAppContextHolder.getCurrentUser().getEnterpriseId());
42.     }
44.     @ApiOperation("查看文件信息")
45.     @GetMapping(value = "/info")
46.     public FileDTO fileInfo(@RequestParam(value = "id") Long id) throws IOException {
47.         return fileApplicationService.findById(id);
48.     }
50.     @ApiOperation("下载视频")
51.     @GetMapping(value = "/downloadFile2")
52.     public void download2(@RequestParam(value = "id") Long id, HttpServletRequest request, HttpServletResponse response) throws IOException {
53.         fileApplicationService.downloadVideo(request, response, id, UserAppContextHolder.getCurrentUser().getEnterpriseId());
54.     }
55. }

复制代码

1. package com.javagpt.application.file;
3. import com.javagpt.common.exception.BusinessRuntimeException;
4. import com.javagpt.common.oos.OssService;
5. import com.javagpt.common.util.ModelUtils;
6. import com.javagpt.common.util.SpringResponseUtils;
7. import com.javagpt.file.entity.FileEntity;
8. import com.javagpt.file.repository.FileRepository;
9. import jakarta.servlet.http.HttpServletRequest;
10. import jakarta.servlet.http.HttpServletResponse;
11. import lombok.RequiredArgsConstructor;
12. import lombok.extern.slf4j.Slf4j;
13. import org.apache.commons.io.FilenameUtils;
14. import org.apache.commons.io.IOUtils;
15. import org.apache.commons.lang3.StringUtils;
16. import org.springframework.http.HttpHeaders;
17. import org.springframework.stereotype.Service;
18. import org.springframework.transaction.annotation.Transactional;
19. import org.springframework.web.multipart.MultipartFile;
21. import java.io.*;
23. @Service
24. @Slf4j
25. @RequiredArgsConstructor
26. public class FileApplicationService {
28.     private final OssService ossService;
30.     private final FileRepository fileRepository;
33.     public FileDTO findById(Long id) {
34.         FileEntity fileEntity = fileRepository.findById(id);
35.         return ModelUtils.convert(fileEntity, FileDTO.class);
36.     }
38.     @Transactional
39.     public FileDTO saveFile(Long enterpriseId, MultipartFile file) {
40.         FileEntity fileEntity = saveFile(enterpriseId, file, null);
41.         return ModelUtils.convert(fileEntity, FileDTO.class);
42.     }
44.     @Transactional
45.     public FileEntity saveFile(Long enterpriseId, MultipartFile file, String fileName) {
46.         String originalFilename = file.getOriginalFilename();
47.         String name = StringUtils.isBlank(fileName) ? FilenameUtils.getBaseName(originalFilename) : fileName;
48.         String suffix = FilenameUtils.getExtension(originalFilename);
49.         long size = file.getSize();
50.         FileEntity fileEntity = new FileEntity();
51.         fileEntity.setName(name).setSuffix(suffix).setSize(size).setEnterpriseId(enterpriseId);
52.         fileEntity = fileEntity.save();
53.         String key = fileEntity.getPath();
54.         InputStream inputStream = null;
55.         try {
56.             inputStream = file.getInputStream();
57.         } catch (IOException e) {
58.             log.error("saveFile error:", e);
59.             throw BusinessRuntimeException.error("上传文件失败");
60.         }
61.         ossService.uploadFile(inputStream, key);
62.         IOUtils.closeQuietly(inputStream);
63.         return fileEntity;
64.     }
67.     @Transactional
68.     public FileEntity saveFile(File file) {
69.         long size = file.length();
70.         FileEntity fileEntity = new FileEntity();
71.         String baseName = FilenameUtils.getBaseName(file.getName());
72.         String extension = FilenameUtils.getExtension(file.getName());
73.         fileEntity.setName(baseName).setSuffix(extension).setSize(size);
74.         fileEntity = fileEntity.save();
75.         String key = fileEntity.getPath();
76.         FileInputStream inputStream = null;
77.         try {
78.             inputStream = new FileInputStream(file);
79.             ossService.uploadFile(inputStream, key);
80.         } catch (FileNotFoundException e) {
81.             log.error("saveFile error:", e);
82.             throw BusinessRuntimeException.error("上传文件失败");
83.         }
84.         IOUtils.closeQuietly(inputStream);
85.         return fileEntity;
86.     }
89.     public void downloadFile(HttpServletResponse response, Long fileId, Long enterpriseId) throws IOException {
90.         FileEntity fileEntity = fileRepository.findById(fileId);
91.         if (fileEntity == null) {
92.             throw BusinessRuntimeException.error("无效的文件Id");
93.         }
94.         String key = fileEntity.getPath();
95.         InputStream inputStream = ossService.downloadFile(key);
96.         SpringResponseUtils.writeAndFlushResponse(inputStream, response, fileEntity.fileFullName());
97.     }
100.     public void downloadVideo(HttpServletRequest request, HttpServletResponse response, Long fileId, Long enterpriseId) throws IOException {
102.         FileEntity fileEntity = fileRepository.findById(fileId);
103.         if (fileEntity == null) {
104.             throw BusinessRuntimeException.error("无效的文件Id");
105.         }
106.         response.setHeader(HttpHeaders.ACCEPT_RANGES, "bytes");
107.         Long fileSize = fileEntity.getSize();
108.         long start = 0, end = fileSize - 1;
109.         //判断前端需不需要分片下载
110.         if (StringUtils.isNotBlank(request.getHeader("Range"))) {
111.             response.setStatus(HttpServletResponse.SC_PARTIAL_CONTENT);
112.             String numRange = request.getHeader("Range").replaceAll("bytes=", "");
113.             String[] strRange = numRange.split("-");
114.             if (strRange.length == 2) {
115.                 start = Long.parseLong(strRange[0].trim());
116.                 end = Long.parseLong(strRange[1].trim());
117.                 //若结束字节超出文件大小 取文件大小
118.                 if (end > fileSize - 1) {
119.                     end = fileSize - 1;
120.                 }
121.             } else {
122.                 //若只给一个长度  开始位置一直到结束
123.                 start = Long.parseLong(numRange.replaceAll("-", "").trim());
124.             }
125.         }
126.         long rangeLength = end - start + 1;
127.         String contentRange = new StringBuffer("bytes ").append(start).append("-").append(end).append("/").append(fileSize).toString();
128.         response.setHeader(HttpHeaders.CONTENT_RANGE, contentRange);
129.         response.setHeader(HttpHeaders.CONTENT_LENGTH, String.valueOf(rangeLength));
130.         String key = fileEntity.getPath();
131.         InputStream inputStream = ossService.downloadFile2(key, start, end);
132.         SpringResponseUtils.writeAndFlushResponse(inputStream, response, fileEntity.fileFullName());
133.     }
134. }

复制代码

总之，MultipartFile接口在Web应用中具有广泛的应用场景，可以实现文件上传、下载、编辑、预览和批量处理等功能。通过熟练把握MultipartFile接口的利用方法和技巧，我们可以更加高效地处理文件上传和下载请求，提升Web应用的用户体验和功能性能。
   本文由博客一文多发平台 OpenWrite 发布！

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。