This class represents a file or form item that was received within a multipart/form-data
POST request.
After retrieving an instance of this class from a {@link org.apache.tomcat.util.http.fileupload.FileUpload FileUpload} instance (see{@link org.apache.tomcat.util.http.fileupload.FileUpload#parseRequest(RequestContext)}), you may either request all contents of the file at once using {@link #get()} orrequest an {@link java.io.InputStream InputStream} with{@link #getInputStream()} and process the file without attempting to loadit into memory, which may come handy with large files.
While this interface does not extend javax.activation.DataSource
per se (to avoid a seldom used dependency), several of the defined methods are specifically defined with the same signatures as methods in that interface. This allows an implementation of this interface to also implement javax.activation.DataSource
with minimal additional work.
@version $Id: FileItem.java 1470437 2013-04-22 10:35:10Z markt $
@since 1.3 additionally implements FileItemHeadersSupport