Skip to content

Commit 8391897

Browse files
committed
Document removal of CommonsMultipartResolver in MVC setup documentation
Closes gh-29562
1 parent a3c8909 commit 8391897

File tree

1 file changed

+4
-23
lines changed

1 file changed

+4
-23
lines changed

framework-docs/src/docs/asciidoc/web/webmvc.adoc

Lines changed: 4 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1141,9 +1141,10 @@ request with a simple request parameter.
11411141
[.small]#<<web-reactive.adoc#webflux-multipart, WebFlux>>#
11421142

11431143
`MultipartResolver` from the `org.springframework.web.multipart` package is a strategy
1144-
for parsing multipart requests including file uploads. There is one implementation
1145-
based on https://commons.apache.org/proper/commons-fileupload[Commons FileUpload] and
1146-
another based on Servlet multipart request parsing.
1144+
for parsing multipart requests including file uploads. There is a container-based
1145+
`StandardServletMultipartResolver` implementation for Servlet multipart request parsing.
1146+
Note that the outdated `CommonsMultipartResolver` based on Apache Commons FileUpload is
1147+
not available anymore, as of Spring Framework 6.0 with its new Servlet 5.0+ baseline.
11471148

11481149
To enable multipart handling, you need to declare a `MultipartResolver` bean in your
11491150
`DispatcherServlet` Spring configuration with a name of `multipartResolver`.
@@ -1153,26 +1154,6 @@ content wraps the current `HttpServletRequest` as a `MultipartHttpServletRequest
11531154
provide access to resolved files in addition to exposing parts as request parameters.
11541155

11551156

1156-
[[mvc-multipart-resolver-commons]]
1157-
==== Apache Commons `FileUpload`
1158-
1159-
To use Apache Commons `FileUpload`, you can configure a bean of type
1160-
`CommonsMultipartResolver` with a name of `multipartResolver`. You also need to have
1161-
the `commons-fileupload` jar as a dependency on your classpath.
1162-
1163-
This resolver variant delegates to a local library within the application, providing
1164-
maximum portability across Servlet containers. As an alternative, consider standard
1165-
Servlet multipart resolution through the container's own parser as discussed below.
1166-
1167-
[NOTE]
1168-
====
1169-
Commons FileUpload traditionally applies to POST requests only but accepts any
1170-
`multipart/` content type. See the
1171-
{api-spring-framework}/web/multipart/commons/CommonsMultipartResolver.html[`CommonsMultipartResolver`]
1172-
javadoc for details and configuration options.
1173-
====
1174-
1175-
11761157
[[mvc-multipart-resolver-standard]]
11771158
==== Servlet Multipart Parsing
11781159

0 commit comments

Comments
 (0)