Cached contents of the file.
Checks to see if writing the specified number of bytes would cause the
configured threshold to be exceeded.
Closes this output stream and releases any system resources associated
with this stream.
HTTP content disposition header name.
HTTP content type header name.
The content type passed by the browser, or null
if
not defined.
Counter used in unique identifier generation.
Create a new
DefaultFileItem
instance from the supplied parameters and the local factory
configuration.
Create a new
FileItem
instance from the supplied parameters and
any local factory configuration.
The output stream to which data will be written at any given time.
The default length of the buffer used for processing a request.
The default threshold above which uploads will be stored on disk.
The default implementation of the
FileItem
interface.
Constructs a new DefaultFileItem
instance.
Constructs an unconfigured instance of this class.
Constructs a preconfigured instance of this class.
An output stream which will retain data in memory until a specified
threshold is reached, and only then commit it to disk.
Constructs an instance of this class which will trigger an event at the
specified threshold, and save data to a file beyond that point.
Deletes the underlying storage for a file item, including deleting any
associated temporary disk file.
Deletes the underlying storage for a file item, including deleting any
associated temporary disk file.
Output stream for this item.
Reads body-data
from the current
encapsulation
and discards it.
High level API for processing file uploads.
Constructs an instance of this class which uses the default factory to
create FileItem
instances.
Constructs an instance of this class which uses the supplied factory to
create FileItem
instances.
The output stream to which data will be written after the theshold is
reached.
A byte sequence that that follows a delimiter that will be
followed by an encapsulation (CRLF
).
The name of the form field as provided by the browser.
This class represents a file or form item that was received within a
multipart/form-data
POST request.
The factory to use to create new form items.
The factory to use to create new form items.
A factory interface for creating
FileItem
instances.
The original filename in the user's filesystem.
High level API for processing file uploads.
Constructs an instance of this class which uses the default factory to
create FileItem
instances.
Constructs an instance of this class which uses the supplied factory to
create FileItem
instances.
High level API for processing file uploads.
Exception for errors encountered while processing the request.
Constructs a new FileUploadException
without message.
Constructs a new FileUploadException
with specified detail
message.
Removes the file contents from the temporary storage.
Searches for a byte of specified value in the buffer
,
starting at the specified position
.
Searches for the boundary
in the buffer
region delimited by head
and tail
.
Flushes this output stream and forces any buffered output bytes to be
written out.
Content-disposition value for form data.
Returns the contents of the file as an array of bytes.
Returns the contents of the file item as an array of bytes.
Returns the number of bytes that have been written to this output stream.
Returns the content type passed by the browser or null
if
not defined.
Returns the content type passed by the browser or null
if
not defined.
Returns the data for this output stream as an array of bytes, assuming
that the data has been retained in memory.
Returns the name of the field in the multipart form corresponding to
this file item.
Returns the name of the field in the multipart form corresponding to
this file item.
Retrieves the field name from the Content-disposition
header.
Returns the data for this output stream as a File
, assuming
that the data was written to disk.
Returns the factory class used when creating file items.
Returns the factory class used when creating file items.
Returns the factory class used when creating file items.
Retrieves the file name from the Content-disposition
header.
Returns the header with the specified name from the supplied map.
Retrieves the character encoding used when reading the headers of an
individual part.
Retrieves the character encoding used when reading the headers of an
individual part.
Returns an InputStream
that can be
used to retrieve the contents of the file.
Returns an InputStream
that can be
used to retrieve the contents of the file.
Returns the original filename in the client's filesystem.
Returns the original filename in the client's filesystem, as provided by
the browser (or other client software).
Returns an OutputStream
that can
be used for storing the contents of the file.
Returns an OutputStream
that can
be used for storing the contents of the file.
Returns the directory used to temporarily store files that are larger
than the configured size threshold.
Returns the location used to temporarily store files that are larger
than the configured size threshold.
Returns the size of the file.
Returns the size of the file item.
Returns the maximum allowed upload size.
Returns the size threshold beyond which files are written directly to
disk.
Returns the size threshold beyond which files are written directly to
disk.
Returns the java.io.File
object for the FileItem
's
data's temporary location on the disk.
Returns the current output stream.
Returns the underlying output stream, to which the corresponding
OutputStream
methods in this class will ultimately delegate.
Returns the contents of the file as a String, using the default
character encoding.
Returns the contents of the file item as a String, using the default
character encoding.
Returns the contents of the file as a String, using the specified
encoding.
Returns the contents of the file item as a String, using the specified
encoding.
Creates and returns a File
representing a uniquely
named temporary file in the configured repository path.
Returns the threshold, in bytes, at which an event will be triggered.
Returns an identifier that is unique within the class loader used to
load this class, but does not have random-like apearance.
Thrown upon attempt of setting an invalid boundary token.
Constructs an IllegalBoundaryException
with no
detail message.
Constructs an IllegalBoundaryException
with
the specified detail message.
The input stream from which data is read.
Thrown to indicate that the request is not a multipart request.
Constructs a InvalidContentTypeException
with no
detail message.
Constructs an InvalidContentTypeException
with
the specified detail message.
Whether or not this item is a simple form field.
Determines whether or not a FileItem
instance represents
a simple form field.
Determines whether or not a FileItem
instance represents
a simple form field.
Provides a hint as to whether or not the file contents will be read
from memory.
Determines whether or not the data for this output stream has been
retained in memory.
Provides a hint as to whether or not the file contents will be read
from memory.
Utility method that determines whether the request contains multipart
content.
Determines whether or not the configured threshold has been exceeded for
this output stream.
Thrown to indicate that the input stream fails to follow the
required syntax.
Constructs a MalformedStreamException
with no
detail message.
Constructs an MalformedStreamException
with
the specified detail message.
The maximum length of a single header line that will be parsed
(1024 bytes).
The output stream to which data will be written prior to the theshold
being reached.
Part of HTTP content type header.
HTTP content type header for multipart forms.
HTTP content type header for multiple uploads.
Low level API for processing file uploads.
Constructs a MultipartStream
with a default size buffer.
Constructs a MultipartStream
with a custom size buffer.
Reads body-data
from the current
encapsulation
and writes its contents into the
output Stream
.
Skips a boundary
token, and checks whether more
encapsulations
are contained in the stream.
Reads a byte from the buffer
, and refills it as
necessary.
Reads the header-part
of the current
encapsulation
.
The directory in which uploaded files will be stored, if stored on disk.
The directory in which uploaded files will be stored, if stored on disk.
Changes the boundary token used for partitioning the stream.
Sets the field name used to reference this file item.
Sets the field name used to reference this file item.
Sets the factory class to use when creating file items.
Sets the factory class to use when creating file items.
Sets the factory class to use when creating file items.
Specifies whether or not a FileItem
instance represents
a simple form field.
Specifies whether or not a FileItem
instance represents
a simple form field.
Specifies the character encoding to be used when reading the headers of
individual parts.
Specifies the character encoding to be used when reading the headers of
individual parts.
Sets the directory used to temporarily store files that are larger
than the configured size threshold.
Sets the location used to temporarily store files that are larger
than the configured size threshold.
Sets the maximum allowed upload size.
Sets the size threshold beyond which files are written directly to disk.
Sets the size threshold beyond which files are written directly to disk.
Thrown to indicate that the request size exceeds the configured maximum.
Constructs a SizeExceededException
with no
detail message.
Constructs an SizeExceededException
with
the specified detail message.
The maximum size permitted for an uploaded file.
The threshold above which uploads will be stored on disk.
The threshold above which uploads will be stored on disk.
Finds the beginning of the first encapsulation
.
A byte sequence that that follows a delimiter of the last
encapsulation in the stream (--
).
The index of last valid characer in the buffer + 1.
The threshold at which the event will be triggered.
Whether or not the configured threshold has been exceeded.
An output stream which triggers an event when a specified number of bytes of
data have been written to it.
Constructs an instance of this class which will trigger an event at the
specified threshold.
Switches the underlying output stream from a memory based stream to one
that is backed by disk.
Indicates that the configured threshold has been reached, and that a
subclass should take whatever action necessary on this event.
Returns a string representation of this object.