多部分解析器
org.springframework.web.multipart
包中的 MultipartResolver
是用于解析多部分请求(包括文件上传)的策略。对于 Servlet 多部分请求解析,有一个基于容器的 StandardServletMultipartResolver
实现。请注意,自 Spring Framework 6.0 及其新的 Servlet 5.0+ 基线以来,基于 Apache Commons FileUpload 的过时的 CommonsMultipartResolver
已不再可用。
要启用多部分处理,您需要在 DispatcherServlet
Spring 配置中声明一个名为 multipartResolver
的 MultipartResolver
Bean。DispatcherServlet
会检测到它并将其应用于传入的请求。当收到内容类型为 multipart/form-data
的 POST 请求时,解析器会解析内容并将当前的 HttpServletRequest
包装为 MultipartHttpServletRequest
,以便除了将部分内容作为请求参数公开外,还可以访问解析后的文件。
Servlet 多部分解析
Servlet 多部分解析需要通过 Servlet 容器配置启用。为此
-
在 Java 中,在 Servlet 注册上设置
MultipartConfigElement
。 -
在
web.xml
中,向 servlet 声明添加"<multipart-config>"
部分。
以下示例演示如何在 Servlet 注册上设置 MultipartConfigElement
-
Java
-
Kotlin
public class AppInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
// ...
@Override
protected void customizeRegistration(ServletRegistration.Dynamic registration) {
// Optionally also set maxFileSize, maxRequestSize, fileSizeThreshold
registration.setMultipartConfig(new MultipartConfigElement("/tmp"));
}
}
class AppInitializer : AbstractAnnotationConfigDispatcherServletInitializer() {
// ...
override fun customizeRegistration(registration: ServletRegistration.Dynamic) {
// Optionally also set maxFileSize, maxRequestSize, fileSizeThreshold
registration.setMultipartConfig(MultipartConfigElement("/tmp"))
}
}
一旦 Servlet 多部分配置就位,您就可以添加一个名为 multipartResolver
的类型为 StandardServletMultipartResolver
的 Bean。
此解析器变体按原样使用您的 Servlet 容器的多部分解析器,这可能会使应用程序容易受到容器实现差异的影响。默认情况下,它将尝试解析任何 HTTP 方法的任何 |