org.apache.tomcat.util.http.fileupload
public class DiskFileUpload extends FileUploadBase
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 DiskFileUpload to acquire a list of FileItems associated with a given HTML
widget.
Individual parts will be stored in temporary disk storage or in memory, depending on their size, and will be available as FileItems.
Version: $Id: DiskFileUpload.java 467222 2006-10-24 03:17:11Z markt $
Constructor Summary | |
---|---|
DiskFileUpload()
Constructs an instance of this class which uses the default factory to
create FileItem instances.
| |
DiskFileUpload(DefaultFileItemFactory fileItemFactory)
Constructs an instance of this class which uses the supplied factory to
create FileItem instances.
|
Method Summary | |
---|---|
FileItemFactory | getFileItemFactory()
Returns the factory class used when creating file items.
|
String | getRepositoryPath()
Returns the location used to temporarily store files that are larger
than the configured size threshold.
|
int | getSizeThreshold()
Returns the size threshold beyond which files are written directly to
disk.
|
List | parseRequest(HttpServletRequest req, int sizeThreshold, long sizeMax, String path)
Processes an RFC 1867
compliant multipart/form-data stream. |
void | setFileItemFactory(FileItemFactory factory)
Sets the factory class to use when creating file items. |
void | setRepositoryPath(String repositoryPath)
Sets the location used to temporarily store files that are larger
than the configured size threshold.
|
void | setSizeThreshold(int sizeThreshold)
Sets the size threshold beyond which files are written directly to disk.
|
FileItem
instances.
See Also: DiskFileUpload
FileItem
instances.
See Also: DiskFileUpload
Returns: The factory class for new file items.
Returns: The path to the temporary file location.
See Also: setRepositoryPath
Returns: The size threshold, in bytes.
See Also: DiskFileUpload
multipart/form-data
stream. If files are stored
on disk, the path is given by getRepository()
.
Parameters: req The servlet request to be parsed. Must be non-null. sizeThreshold The max size in bytes to be stored in memory. sizeMax The maximum allowed upload size, in bytes. path The location where the files should be stored.
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.
DefaultFileItemFactory
or a subclass
thereof, or else a ClassCastException
will be thrown.
Parameters: factory The factory class for new file items.
Parameters: repositoryPath The path to the temporary file location.
See Also: getRepositoryPath
Parameters: sizeThreshold The size threshold, in bytes.
See Also: getSizeThreshold