java.lang.Object | ||
↳ | org.springframework.web.multipart.commons.CommonsFileUploadSupport | |
↳ | org.springframework.web.multipart.commons.CommonsMultipartResolver |
Servlet-based MultipartResolver
implementation
for Jakarta Commons FileUpload
1.2 or above.
Provides "maxUploadSize", "maxInMemorySize" and "defaultEncoding" settings as
bean properties (inherited from CommonsFileUploadSupport
). See corresponding
ServletFileUpload / DiskFileItemFactory properties ("sizeMax", "sizeThreshold",
"headerEncoding") for details in terms of defaults and accepted values.
Saves temporary files to the servlet container's temporary directory. Needs to be initialized either by an application context or via the constructor that takes a ServletContext (for standalone usage).
CommonsMultipartResolver(ServletContext)
setResolveLazily(boolean)
CommonsPortletMultipartResolver
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.springframework.web.multipart.commons.CommonsFileUploadSupport
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructor for use as bean.
| |||||||||||
Constructor for standalone usage.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Cleanup any resources used for the multipart handling,
like a storage for the uploaded files.
| |||||||||||
Determine if the given request contains multipart content.
| |||||||||||
Parse the given HTTP request into multipart files and parameters,
and wrap the request inside a
MultipartHttpServletRequest object
that provides access to file descriptors and makes contained
parameters accessible via the standard ServletRequest methods. | |||||||||||
Set whether to resolve the multipart request lazily at the time of
file or parameter access.
| |||||||||||
Set the ServletContext that this object runs in.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Determine the encoding for the given request.
| |||||||||||
Initialize the underlying
org.apache.commons.fileupload.servlet.ServletFileUpload
instance. | |||||||||||
Parse the given servlet request, resolving its multipart elements.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.springframework.web.multipart.commons.CommonsFileUploadSupport
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
org.springframework.web.context.ServletContextAware
| |||||||||||
From interface
org.springframework.web.multipart.MultipartResolver
|
Constructor for use as bean. Determines the servlet container's temporary directory via the ServletContext passed in as through the ServletContextAware interface (typically by a WebApplicationContext).
Constructor for standalone usage. Determines the servlet container's temporary directory via the given ServletContext.
servletContext | the ServletContext to use |
---|
Cleanup any resources used for the multipart handling, like a storage for the uploaded files.
request | the request to cleanup resources for |
---|
Determine if the given request contains multipart content.
Will typically check for content type "multipart/form-data", but the actually accepted requests might depend on the capabilities of the resolver implementation.
request | the servlet request to be evaluated |
---|
Parse the given HTTP request into multipart files and parameters,
and wrap the request inside a
MultipartHttpServletRequest
object
that provides access to file descriptors and makes contained
parameters accessible via the standard ServletRequest methods.
request | the servlet request to wrap (must be of a multipart content type) |
---|
MultipartException |
---|
Set whether to resolve the multipart request lazily at the time of file or parameter access.
Default is "false", resolving the multipart elements immediately, throwing
corresponding exceptions at the time of the resolveMultipart(HttpServletRequest)
call.
Switch this to "true" for lazy multipart parsing, throwing parse exceptions
once the application attempts to obtain multipart files or parameters.
Set the ServletContext that this object runs in.
Invoked after population of normal bean properties but before an init
callback like InitializingBean's afterPropertiesSet
or a
custom init-method. Invoked after ApplicationContextAware's
setApplicationContext
.
servletContext | ServletContext object to be used by this object |
---|
Determine the encoding for the given request. Can be overridden in subclasses.
The default implementation checks the request encoding, falling back to the default encoding specified for this resolver.
request | current HTTP request |
---|
null
)Initialize the underlying org.apache.commons.fileupload.servlet.ServletFileUpload
instance. Can be overridden to use a custom subclass, e.g. for testing purposes.
fileItemFactory | the Commons FileItemFactory to use |
---|
Parse the given servlet request, resolving its multipart elements.
request | the request to parse |
---|
MultipartException | if multipart resolution failed. |
---|