org.apache.commons.fileupload.servlet
Class ServletFileUpload
java.lang.Object
org.apache.commons.fileupload.FileUploadBase
org.apache.commons.fileupload.FileUpload
org.apache.commons.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/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.
- Version:
- $Id: ServletFileUpload.java 350090 2005-12-01 00:56:20Z martinc $
- Author:
- Rafal Krzewski, Daniel Rall, Jason van Zyl, John McNally, Martin Cooper, Sean C. Sullivan
Fields inherited from class org.apache.commons.fileupload.FileUpload |
|
Method Summary |
java.util.List |
parseRequest(javax.servlet.http.HttpServletRequest request)
Processes an RFC 1867
compliant multipart/form-data stream. |
Methods inherited from class org.apache.commons.fileupload.FileUploadBase |
createItem, getBoundary, getFieldName, getFileName, getHeader, getHeaderEncoding, getSizeMax, isMultipartContent, isMultipartContent, parseHeaders, parseRequest, setHeaderEncoding, setSizeMax |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
ServletFileUpload
public ServletFileUpload()
- Constructs an uninitialised instance of this class. A factory must be
configured, using
setFileItemFactory()
, before attempting
to parse requests.
- See Also:
FileUpload.FileUpload(FileItemFactory)
ServletFileUpload
public ServletFileUpload(FileItemFactory fileItemFactory)
- Constructs an instance of this class which uses the supplied factory to
create
FileItem
instances.
- See Also:
FileUpload.FileUpload()
parseRequest
public java.util.List parseRequest(javax.servlet.http.HttpServletRequest request)
throws FileUploadException
- Processes an RFC 1867
compliant
multipart/form-data
stream.
- Overrides:
parseRequest
in class FileUploadBase
- Parameters:
request
- The servlet request to be parsed.
- Returns:
- A list of
FileItem
instances parsed from the
request, in the order that they were transmitted.
- Throws:
FileUploadException
- if there are problems reading/parsing
the request or storing files.