Class ServletFileUpload
- java.lang.Object
- 
- org.apache.tomcat.util.http.fileupload.FileUploadBase
- 
- org.apache.tomcat.util.http.fileupload.FileUpload
- 
- org.apache.tomcat.util.http.fileupload.servlet.ServletFileUpload
 
 
 
- 
 public class ServletFileUpload extends FileUpload High level API for processing file uploads. This class handles multiple files per single HTML widget, sent using multipart/mixedencoding type, as specified by RFC 1867. UseFileUploadBase.parseRequest(org.apache.tomcat.util.http.fileupload.RequestContext)to acquire a list ofFileItems associated with a given HTML widget.How the data for individual parts is stored is determined by the factory used to create them; a given part may be in memory, on disk, or somewhere else. 
- 
- 
Field Summary- 
Fields inherited from class org.apache.tomcat.util.http.fileupload.FileUploadBaseATTACHMENT, CONTENT_DISPOSITION, CONTENT_LENGTH, CONTENT_TYPE, FORM_DATA, MULTIPART, MULTIPART_FORM_DATA, MULTIPART_MIXED
 
- 
 - 
Constructor SummaryConstructors Constructor Description ServletFileUpload()Constructs an uninitialized instance of this class.ServletFileUpload(FileItemFactory fileItemFactory)Constructs an instance of this class which uses the supplied factory to createFileIteminstances.
 - 
Method SummaryAll Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description FileItemIteratorgetItemIterator(HttpServletRequest request)Processes an RFC 1867 compliantmultipart/form-datastream.static booleanisMultipartContent(HttpServletRequest request)Utility method that determines whether the request contains multipart content.java.util.Map<java.lang.String,java.util.List<FileItem>>parseParameterMap(HttpServletRequest request)Processes an RFC 1867 compliantmultipart/form-datastream.- 
Methods inherited from class org.apache.tomcat.util.http.fileupload.FileUploadgetFileItemFactory, setFileItemFactory
 - 
Methods inherited from class org.apache.tomcat.util.http.fileupload.FileUploadBasegetBoundary, getFieldName, getFileCountMax, getFileName, getFileSizeMax, getHeaderEncoding, getItemIterator, getParsedHeaders, getProgressListener, getSizeMax, isMultipartContent, newFileItemHeaders, parseParameterMap, parseRequest, setFileCountMax, setFileSizeMax, setHeaderEncoding, setProgressListener, setSizeMax
 
- 
 
- 
- 
- 
Constructor Detail- 
ServletFileUploadpublic ServletFileUpload() Constructs an uninitialized instance of this class. A factory must be configured, usingsetFileItemFactory(), before attempting to parse requests.- See Also:
- FileUpload(FileItemFactory)
 
 - 
ServletFileUploadpublic ServletFileUpload(FileItemFactory fileItemFactory) Constructs an instance of this class which uses the supplied factory to createFileIteminstances.- Parameters:
- fileItemFactory- The factory to use for creating file items.
- See Also:
- FileUpload()
 
 
- 
 - 
Method Detail- 
isMultipartContentpublic static final boolean isMultipartContent(HttpServletRequest request) Utility method that determines whether the request contains multipart content.- Parameters:
- request- The servlet request to be evaluated. Must be non-null.
- Returns:
- trueif the request is multipart;- falseotherwise.
 
 - 
parseParameterMappublic java.util.Map<java.lang.String,java.util.List<FileItem>> parseParameterMap(HttpServletRequest request) throws FileUploadException Processes an RFC 1867 compliantmultipart/form-datastream.- Parameters:
- request- The servlet request to be parsed.
- Returns:
- A map of FileIteminstances parsed from the request.
- Throws:
- FileUploadException- if there are problems reading/parsing the request or storing files.
- Since:
- 1.3
 
 - 
getItemIteratorpublic FileItemIterator getItemIterator(HttpServletRequest request) throws FileUploadException, java.io.IOException Processes an RFC 1867 compliantmultipart/form-datastream.- Parameters:
- request- The servlet request to be parsed.
- Returns:
- An iterator to instances of FileItemStreamparsed from the request, in the order that they were transmitted.
- Throws:
- FileUploadException- if there are problems reading/parsing the request or storing files.
- java.io.IOException- An I/O error occurred. This may be a network error while communicating with the client or a problem while storing the uploaded content.
 
 
- 
 
-