Class 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 FileItems 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
    • Constructor Detail

      • 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(FileItemFactory)
      • ServletFileUpload

        public ServletFileUpload​(FileItemFactory fileItemFactory)
        Constructs an instance of this class which uses the supplied factory to create FileItem instances.
        See Also:
        FileUpload()
    • Method Detail

      • 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.