Spring MVC文件上传：commons-fileupload解析全流程

🧩 一、整体上传流程（Spring MVC + commons-fileupload）

当用户通过浏览器上传文件（如<form enctype="multipart/form-data">）时，整个流程如下：

[浏览器] ↓ (HTTP POST with multipart/form-data) [Servlet 容器（如 Tomcat）] ↓ （原始 HttpServletRequest） [Spring DispatcherServlet] ↓ （检测到 multipart 请求） [CommonsMultipartResolver] ↓ （调用 commons-fileupload 解析请求体） [生成 CommonsMultipartFile 对象] ↓ （注入到 Controller 方法参数或自定义 Bean 中） [你的业务代码：importValuation(FileUpLoadBean file)]

⏱️ 二、commons-fileupload 在哪个阶段起作用？

✅ 关键阶段：请求解析阶段（在 Controller 执行之前）

具体来说：

1. DispatcherServlet 收到请求
   判断Content-Type是否为multipart/form-data。

2. 调用 MultipartResolver
   如果配置了CommonsMultipartResolver，Spring 会委托它处理该请求。

3. CommonsMultipartResolver 内部使用 commons-fileupload

   • 调用ServletFileUpload.parseRequest(request)（来自commons-fileupload库）
   • 将原始字节流解析为一个个FileItem（代表每个表单项，包括文件和普通字段）
   • 把文件类型的FileItem封装成CommonsMultipartFile对象

4. 替换原始 Request
   Spring 会把原始的HttpServletRequest包装成MultipartHttpServletRequest，其中包含解析好的文件和参数。

5. Controller 方法被调用
   Spring 通过数据绑定（Data Binding），将MultipartHttpServletRequest中的文件自动赋值给你的FileUpLoadBean.file字段（类型为CommonsMultipartFile）。

🔍所以，commons-fileupload的作用发生在 Controller 执行之前，是“幕后解析者”。

🛠️ 三、commons-fileupload 的核心作用是什么？

commons-fileupload是 Apache 提供的一个通用的 multipart/form-data 请求解析库。它的主要职责是：

💡 注意：commons-fileupload本身与 Spring 无关，它是一个独立的工具库。
Spring 只是封装了它，通过CommonsMultipartResolver和CommonsMultipartFile使其融入 MVC 框架。

📦 四、关键类关系图（简化）

commons-fileupload 库： └── ServletFileUpload └── parseRequest() → List<FileItem> └── FileItem (代表一个表单项) ├── isFormField() → true/false ├── getName() → 字段名（如 "file"） ├── getString() → 普通字段值 └── getInputStream() → 文件内容流 Spring 封装层： └── CommonsMultipartResolver └── 使用 ServletFileUpload 解析请求 └── 将 FileItem → CommonsMultipartFile └── getFileItem() → 返回底层 FileItem └── getInputStream() → 代理调用 FileItem.getInputStream()

🧪 五、你项目中的具体体现

• 你配置了CommonsMultipartResolver→ 启用commons-fileupload解析。
• 你使用CommonsMultipartFile→ 直接暴露了底层实现。
• 当用户 POST 到/importValuation.action时：
  • commons-fileupload已经在进入方法前完成了文件解析；
  • file.getFile()返回的就是它解析出的文件对象；
  • 你可以安全地调用.isEmpty(),.getInputStream(),.getOriginalFilename()等方法。

🆚 对比：不用 commons-fileupload 的情况（Servlet 3.0+）

如果使用StandardServletMultipartResolver（Spring Boot 默认）：

• 不需要commons-fileupload依赖；
• 文件类型是StandardMultipartFile；
• 解析工作由Servlet 容器（如 Tomcat）完成；
• 功能类似，但配置方式不同（通过multipart-config或application.properties）。

✅ 总结

如果你后续想优化性能（如限制内存使用、支持大文件分片）、或迁移到更现代的方案（如 Spring Boot + Servlet 3.0+），也可以继续问我！