文件秒传示例

## 前言在开发Web应用时，文件上传是一个常见需求。然而，当用户需要上传大文件或相同文件多次时，会造成带宽浪费和服务器存储冗余。此时可以使用**文件秒传**技术通过识别重复文件，实现瞬间完成上传的效果，大大提升了用户体验和系统效率。 ## 文件秒传原理 **文件秒传**的核心原理是： 1. 计算文件唯一标识（通常是MD5或SHA256值） 2. 上传前先检查服务器是否已存在相同标识的文件 3. 若存在，则直接引用已有文件，无需再次上传 4. 若不存在，则执行常规上传流程这种方式能**显著减少网络传输**和**避免存储冗余**。 ## 代码实现 ### 1. 创建项目基础结构首先创建Spring Boot项目，添加必要依赖： org.springframework.boot spring-boot-starter-web 2.7.18 cn.hutool hutool-all 5.8.1 ### 2. 创建上传存储代码此处使用一个简单的集合来存储文件信息，实际使用需要替换为数据库或其他持久化中间件。 import cn.hutool.crypto.digest.DigestUtil; import org.springframework.stereotype.Service; import org.springframework.web.multipart.MultipartFile; import java.io.IOException; import java.util.Map; import java.util.concurrent.ConcurrentHashMap; @Service public class FileService { // 使用Map存储文件信息，key为MD5，value为文件信息（实际使用时可替换为数据库存储） private final Map fileStore = new ConcurrentHashMap<>(); /** * 检查文件是否已存在 */ public FileInfo findByMd5(String md5) { return fileStore.get(md5); } /** * 保存文件信息 */ public FileInfo saveFile(String fileName, String fileMd5, Long fileSize, String filePath) { FileInfo fileInfo = new FileInfo(fileName, fileMd5, fileSize, filePath); fileStore.put(fileMd5, fileInfo); // 实际使用时插入数据库 return fileInfo; } /** * 计算文件MD5 */ public String calculateMD5(MultipartFile file) throws IOException { return DigestUtil.md5Hex(file.getInputStream()); } } 定义一个简单的文件信息实体类： import cn.hutool.core.util.IdUtil; public class FileInfo { private String id = IdUtil.fastUUID(); private String fileName; private String fileMd5; private Long fileSize; private String filePath; public FileInfo(String fileName, String fileMd5, Long fileSize, String filePath) { this.fileName = fileName; this.fileMd5 = fileMd5; this.fileSize = fileSize; this.filePath = filePath; } public String getId() { return id; } public void setId(String id) { this.id = id; } public String getFileName() { return fileName; } public void setFileName(String fileName) { this.fileName = fileName; } public String getFileMd5() { return fileMd5; } public void setFileMd5(String fileMd5) { this.fileMd5 = fileMd5; } public Long getFileSize() { return fileSize; } public void setFileSize(Long fileSize) { this.fileSize = fileSize; } public String getFilePath() { return filePath; } public void setFilePath(String filePath) { this.filePath = filePath; } } ### 3. 创建Result类为了统一返回结果格式，可以创建一个简单的Result类。 public class Result { private boolean success; private Object data; private String message; public Result(boolean success, Object data, String message) { this.success = success; this.data = data; this.message = message; } public static Result success(Object data) { return new Result(true, data,"success"); } public static Result success(Object data,String message) { return new Result(true, data,message); } public static Result error(String message) { return new Result(false, null, message); } // Getters public boolean isSuccess() { return success; } public Object getData() { return data; } public String getMessage() { return message; } } ### 4. 创建Controller控制器 import cn.hutool.core.io.FileUtil; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.*; import org.springframework.web.multipart.MultipartFile; import java.io.File; @RestController @RequestMapping("/api/file") public class FileController { private static Logger logger = LoggerFactory.getLogger(FileController.class); @Autowired private FileService fileService; /** * 检查文件是否已存在 */ @PostMapping("/check") public Result checkFile(@RequestParam("md5") String md5) { FileInfo fileInfo = fileService.findByMd5(md5); if (fileInfo != null) { return Result.success(fileInfo); } return Result.success(null); } /** * 上传文件 */ @PostMapping("/upload") public Result uploadFile(@RequestParam("file") MultipartFile file) { try { // 计算文件MD5值 String md5 = fileService.calculateMD5(file); // 检查文件是否已存在 FileInfo existFile = fileService.findByMd5(md5); if (existFile != null) { // todo 进行自定义的逻辑处理 return Result.success(existFile,"文件秒传成功"); } // 文件不存在，执行上传 String originalFilename = file.getOriginalFilename(); String filePath = FileUtil.getTmpDir() + File.separator + originalFilename; // 保存到临时目录 // 存储文件 file.transferTo(new File(filePath)); // 保存文件信息到内存（实际使用时应替换为数据库） FileInfo fileInfo = fileService.saveFile(originalFilename, md5, file.getSize(), filePath); return Result.success(fileInfo,"文件上传成功"); } catch (Exception e) { logger.error(e.getMessage(),e); return Result.error("文件上传失败：" + e.getMessage()); } } } ### 4. 创建纯HTML前端页面创建一个简单的HTML上传页面：文件秒传示例

文件上传（支持秒传）

### 5. 配置文件在`application.yml`中添加必要配置 server: port: 8080 spring: servlet: multipart: max-file-size: 100MB max-request-size: 100MB # 效果 #### 第一次上传 ![image.png](https://p6-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/b349b94b74ed4f2a8d7bf2a636b833d1~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg6aOO6LGh5Y2X:q75.awebp?rk3s=f64ab15b&x-expires=1774304063&x-signature=5NC82CRmK10zpSWhRpbqAjN9FwU%3D) #### 第二次上传 ![](https://p6-xtjj-sign.byteimg.com/tos-cn-i-73owjymdk6/e431ef2ff02a43cda5e78f0350067882~tplv-73owjymdk6-jj-mark-v1:0:0:0:0:5o6Y6YeR5oqA5pyv56S-5Yy6IEAg6aOO6LGh5Y2X:q75.awebp?rk3s=f64ab15b&x-expires=1774304063&x-signature=Z9ltKaK4AA0Fm0hGcRjzShtGgMY%3D)