|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.commons.fileupload.FileUploadBase
org.apache.commons.fileupload.FileUpload
org.apache.commons.fileupload.servlet.ServletFileUpload
public class ServletFileUpload
High level API for processing file uploads.
This class handles multiple files per single HTML widget, sent using
multipart/mixed
encoding type, as specified by
RFC 1867. Use parseRequest(HttpServletRequest)
to acquire a list of FileItem
s 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.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class org.apache.commons.fileupload.FileUploadBase |
---|
FileUploadBase.FileSizeLimitExceededException, FileUploadBase.FileUploadIOException, FileUploadBase.InvalidContentTypeException, FileUploadBase.IOFileUploadException, FileUploadBase.SizeException, FileUploadBase.SizeLimitExceededException, FileUploadBase.UnknownSizeException |
Field Summary |
---|
Fields inherited from class org.apache.commons.fileupload.FileUploadBase |
---|
ATTACHMENT, CONTENT_DISPOSITION, CONTENT_LENGTH, CONTENT_TYPE, FORM_DATA, MAX_HEADER_SIZE, MULTIPART, MULTIPART_FORM_DATA, MULTIPART_MIXED |
Constructor Summary | |
---|---|
ServletFileUpload()
Constructs an uninitialised instance of this class. |
|
ServletFileUpload(FileItemFactory fileItemFactory)
Constructs an instance of this class which uses the supplied factory to create FileItem instances. |
Method Summary | |
---|---|
FileItemIterator |
getItemIterator(javax.servlet.http.HttpServletRequest request)
Processes an RFC 1867 compliant multipart/form-data stream. |
static boolean |
isMultipartContent(javax.servlet.http.HttpServletRequest request)
Utility method that determines whether the request contains multipart content. |
List |
parseRequest(javax.servlet.http.HttpServletRequest request)
Processes an RFC 1867 compliant multipart/form-data stream. |
Methods inherited from class org.apache.commons.fileupload.FileUpload |
---|
getFileItemFactory, setFileItemFactory |
Methods inherited from class org.apache.commons.fileupload.FileUploadBase |
---|
createItem, getBoundary, getFieldName, getFieldName, getFileName, getFileName, getFileSizeMax, getHeader, getHeaderEncoding, getItemIterator, getParsedHeaders, getProgressListener, getSizeMax, isMultipartContent, newFileItemHeaders, parseHeaders, parseRequest, setFileSizeMax, setHeaderEncoding, setProgressListener, setSizeMax |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public ServletFileUpload()
setFileItemFactory()
, before attempting
to parse requests.
FileUpload.FileUpload(FileItemFactory)
public ServletFileUpload(FileItemFactory fileItemFactory)
FileItem
instances.
fileItemFactory
- The factory to use for creating file items.FileUpload.FileUpload()
Method Detail |
---|
public static final boolean isMultipartContent(javax.servlet.http.HttpServletRequest request)
request
- The servlet request to be evaluated. Must be non-null.
true
if the request is multipart;
false
otherwise.public List parseRequest(javax.servlet.http.HttpServletRequest request) throws FileUploadException
multipart/form-data
stream.
parseRequest
in class FileUploadBase
request
- The servlet request to be parsed.
FileItem
instances parsed from the
request, in the order that they were transmitted.
FileUploadException
- if there are problems reading/parsing
the request or storing files.public FileItemIterator getItemIterator(javax.servlet.http.HttpServletRequest request) throws FileUploadException, IOException
multipart/form-data
stream.
request
- The servlet request to be parsed.
FileItemStream
parsed from the request, in the order that they were
transmitted.
FileUploadException
- if there are problems reading/parsing
the request or storing files.
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.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |