类 CommonsMultipartResolver
- java.lang.Object
- org.springframework.web.multipart.commons.CommonsFileUploadSupport
- org.springframework.web.multipart.commons.CommonsMultipartResolver
- 所有已实现的接口:
Aware
,ServletContextAware
,MultipartResolver
public class CommonsMultipartResolver extends CommonsFileUploadSupport implements MultipartResolver, ServletContextAware
Servlet-basedMultipartResolver
implementation for Apache 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).
- 从以下版本开始:
- 29.09.2003
- 作者:
- Trevor D. Cook, Juergen Hoeller
- 另请参阅:
CommonsMultipartResolver(ServletContext)
,setResolveLazily(boolean)
,CommonsPortletMultipartResolver
,ServletFileUpload
,DiskFileItemFactory
嵌套类概要
从类继承的嵌套类/接口 org.springframework.web.multipart.commons.CommonsFileUploadSupport
CommonsFileUploadSupport.MultipartParsingResult
字段概要
从类继承的字段 org.springframework.web.multipart.commons.CommonsFileUploadSupport
logger
构造器概要
构造器 构造器 说明 CommonsMultipartResolver()
Constructor for use as bean.CommonsMultipartResolver(ServletContext servletContext)
Constructor for standalone usage.
方法概要
所有方法 实例方法 具体方法 修饰符和类型 方法 说明 void
cleanupMultipart(MultipartHttpServletRequest request)
Cleanup any resources used for the multipart handling, like a storage for the uploaded files.protected String
determineEncoding(HttpServletRequest request)
Determine the encoding for the given request.boolean
isMultipart(HttpServletRequest request)
Determine if the given request contains multipart content.protected org.apache.commons.fileupload.FileUpload
newFileUpload(org.apache.commons.fileupload.FileItemFactory fileItemFactory)
Initialize the underlyingorg.apache.commons.fileupload.servlet.ServletFileUpload
instance.protected CommonsFileUploadSupport.MultipartParsingResult
parseRequest(HttpServletRequest request)
Parse the given servlet request, resolving its multipart elements.MultipartHttpServletRequest
resolveMultipart(HttpServletRequest request)
Parse the given HTTP request into multipart files and parameters, and wrap the request inside aMultipartHttpServletRequest
object that provides access to file descriptors and makes contained parameters accessible via the standard ServletRequest methods.void
setResolveLazily(boolean resolveLazily)
Set whether to resolve the multipart request lazily at the time of file or parameter access.void
setServletContext(ServletContext servletContext)
Set theServletContext
that this object runs in.从类继承的方法 org.springframework.web.multipart.commons.CommonsFileUploadSupport
cleanupFileItems, createMultipartFile, getDefaultEncoding, getFileItemFactory, getFileUpload, isUploadTempDirSpecified, newFileItemFactory, parseFileItems, prepareFileUpload, setDefaultEncoding, setMaxInMemorySize, setMaxUploadSize, setMaxUploadSizePerFile, setPreserveFilename, setUploadTempDir
构造器详细资料
CommonsMultipartResolver
public CommonsMultipartResolver()
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).
CommonsMultipartResolver
public CommonsMultipartResolver(ServletContext servletContext)
Constructor for standalone usage. Determines the servlet container's temporary directory via the given ServletContext.- 参数:
servletContext
- the ServletContext to use
方法详细资料
setResolveLazily
public void setResolveLazily(boolean resolveLazily)
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(javax.servlet.http.HttpServletRequest)
call. Switch this to "true" for lazy multipart parsing, throwing parse exceptions once the application attempts to obtain multipart files or parameters.
newFileUpload
protected org.apache.commons.fileupload.FileUpload newFileUpload(org.apache.commons.fileupload.FileItemFactory fileItemFactory)
Initialize the underlyingorg.apache.commons.fileupload.servlet.ServletFileUpload
instance. Can be overridden to use a custom subclass, e.g. for testing purposes.- 指定者:
newFileUpload
在类中CommonsFileUploadSupport
- 参数:
fileItemFactory
- the Commons FileItemFactory to use- 返回:
- the new ServletFileUpload instance
setServletContext
public void setServletContext(ServletContext servletContext)
从接口复制的说明:ServletContextAware
Set theServletContext
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'ssetApplicationContext
.- 指定者:
setServletContext
在接口中ServletContextAware
- 参数:
servletContext
- ServletContext object to be used by this object- 另请参阅:
InitializingBean.afterPropertiesSet()
,ApplicationContextAware.setApplicationContext(org.springframework.context.ApplicationContext)
isMultipart
public boolean isMultipart(HttpServletRequest request)
从接口复制的说明:MultipartResolver
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.
- 指定者:
isMultipart
在接口中MultipartResolver
- 参数:
request
- the servlet request to be evaluated- 返回:
- whether the request contains multipart content
resolveMultipart
public MultipartHttpServletRequest resolveMultipart(HttpServletRequest request) throws MultipartException
从接口复制的说明:MultipartResolver
Parse the given HTTP request into multipart files and parameters, and wrap the request inside aMultipartHttpServletRequest
object that provides access to file descriptors and makes contained parameters accessible via the standard ServletRequest methods.- 指定者:
resolveMultipart
在接口中MultipartResolver
- 参数:
request
- the servlet request to wrap (must be of a multipart content type)- 返回:
- the wrapped servlet request
- 抛出:
MultipartException
- if the servlet request is not multipart, or if implementation-specific problems are encountered (such as exceeding file size limits)- 另请参阅:
MultipartRequest.getFile(java.lang.String)
,MultipartRequest.getFileNames()
,MultipartRequest.getFileMap()
,ServletRequest.getParameter(java.lang.String)
,ServletRequest.getParameterNames()
,ServletRequest.getParameterMap()
parseRequest
protected CommonsFileUploadSupport.MultipartParsingResult parseRequest(HttpServletRequest request) throws MultipartException
Parse the given servlet request, resolving its multipart elements.- 参数:
request
- the request to parse- 返回:
- the parsing result
- 抛出:
MultipartException
- if multipart resolution failed.
determineEncoding
protected String determineEncoding(HttpServletRequest request)
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- 返回:
- the encoding for the request (never
null
) - 另请参阅:
ServletRequest.getCharacterEncoding()
,CommonsFileUploadSupport.setDefaultEncoding(java.lang.String)
cleanupMultipart
public void cleanupMultipart(MultipartHttpServletRequest request)
从接口复制的说明:MultipartResolver
Cleanup any resources used for the multipart handling, like a storage for the uploaded files.- 指定者:
cleanupMultipart
在接口中MultipartResolver
- 参数:
request
- the request to cleanup resources for