Class FileUploadBase

  • Direct Known Subclasses:
    DiskFileUpload, FileUpload

    public abstract class FileUploadBase
    extends java.lang.Object

    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(RequestContext) 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.

    • Method Detail

      • isMultipartContent

        public static final boolean isMultipartContent​(RequestContext ctx)

        Utility method that determines whether the request contains multipart content.

        NOTE:This method will be moved to the ServletFileUpload class after the FileUpload 1.1 release. Unfortunately, since this method is static, it is not possible to provide its replacement until this method is removed.

        Parameters:
        ctx - The request context to be evaluated. Must be non-null.
        Returns:
        true if the request is multipart; false otherwise.
      • isMultipartContent

        @Deprecated
        public static boolean isMultipartContent​(javax.servlet.http.HttpServletRequest req)
        Deprecated.
        1.1 Use the method on ServletFileUpload instead.
        Utility method that determines whether the request contains multipart content.
        Parameters:
        req - The servlet request to be evaluated. Must be non-null.
        Returns:
        true if the request is multipart; false otherwise.
      • getFileItemFactory

        public abstract FileItemFactory getFileItemFactory()
        Returns the factory class used when creating file items.
        Returns:
        The factory class for new file items.
      • setFileItemFactory

        public abstract void setFileItemFactory​(FileItemFactory factory)
        Sets the factory class to use when creating file items.
        Parameters:
        factory - The factory class for new file items.
      • getSizeMax

        public long getSizeMax()
        Returns the maximum allowed size of a complete request, as opposed to getFileSizeMax().
        Returns:
        The maximum allowed size, in bytes. The default value of -1 indicates, that there is no limit.
        See Also:
        setSizeMax(long)
      • setSizeMax

        public void setSizeMax​(long sizeMax)
        Sets the maximum allowed size of a complete request, as opposed to setFileSizeMax(long).
        Parameters:
        sizeMax - The maximum allowed size, in bytes. The default value of -1 indicates, that there is no limit.
        See Also:
        getSizeMax()
      • setFileSizeMax

        public void setFileSizeMax​(long fileSizeMax)
        Sets the maximum allowed size of a single uploaded file, as opposed to getSizeMax().
        Parameters:
        fileSizeMax - Maximum size of a single uploaded file.
        See Also:
        getFileSizeMax()
      • getFileCountMax

        public long getFileCountMax()
        Returns the maximum number of files allowed in a single request.
        Returns:
        The maximum number of files allowed in a single request.
      • setFileCountMax

        public void setFileCountMax​(long fileCountMax)
        Sets the maximum number of files allowed per request.
        Parameters:
        fileCountMax - The new limit. -1 means no limit.
      • getHeaderEncoding

        public java.lang.String getHeaderEncoding()
        Retrieves the character encoding used when reading the headers of an individual part. When not specified, or null, the request encoding is used. If that is also not specified, or null, the platform default encoding is used.
        Returns:
        The encoding used to read part headers.
      • setHeaderEncoding

        public void setHeaderEncoding​(java.lang.String encoding)
        Specifies the character encoding to be used when reading the headers of individual part. When not specified, or null, the request encoding is used. If that is also not specified, or null, the platform default encoding is used.
        Parameters:
        encoding - The encoding used to read part headers.
      • getItemIterator

        public FileItemIterator getItemIterator​(RequestContext ctx)
                                         throws FileUploadException,
                                                java.io.IOException
        Processes an RFC 1867 compliant multipart/form-data stream.
        Parameters:
        ctx - The context for the request to be parsed.
        Returns:
        An iterator to instances of FileItemStream parsed from the request, in the order that they were transmitted.
        Throws:
        FileUploadException - if there are problems reading/parsing the request or storing files.
        java.io.IOException - An I/O error occurred. This may be a network error while communicating with the client or a problem while storing the uploaded content.
      • parseRequest

        public java.util.List<FileItemparseRequest​(RequestContext ctx)
                                              throws FileUploadException
        Processes an RFC 1867 compliant multipart/form-data stream.
        Parameters:
        ctx - The context for the 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.
      • parseParameterMap

        public java.util.Map<java.lang.String,​java.util.List<FileItem>> parseParameterMap​(RequestContext ctx)
                                                                                         throws FileUploadException
        Processes an RFC 1867 compliant multipart/form-data stream.
        Parameters:
        ctx - The context for the request to be parsed.
        Returns:
        A map of FileItem instances parsed from the request.
        Throws:
        FileUploadException - if there are problems reading/parsing the request or storing files.
        Since:
        1.3
      • getBoundary

        protected byte[] getBoundary​(java.lang.String contentType)
        Retrieves the boundary from the Content-type header.
        Parameters:
        contentType - The value of the content type header from which to extract the boundary value.
        Returns:
        The boundary, as a byte array.
      • getFileName

        @Deprecated
        protected java.lang.String getFileName​(java.util.Map<java.lang.String,​java.lang.String> headers)
        Deprecated.
        Retrieves the file name from the Content-disposition header.
        Parameters:
        headers - A Map containing the HTTP request headers.
        Returns:
        The file name for the current encapsulation.
      • getFileName

        protected java.lang.String getFileName​(FileItemHeaders headers)
        Retrieves the file name from the Content-disposition header.
        Parameters:
        headers - The HTTP headers object.
        Returns:
        The file name for the current encapsulation.
      • getFieldName

        protected java.lang.String getFieldName​(FileItemHeaders headers)
        Retrieves the field name from the Content-disposition header.
        Parameters:
        headers - A Map containing the HTTP request headers.
        Returns:
        The field name for the current encapsulation.
      • getFieldName

        @Deprecated
        protected java.lang.String getFieldName​(java.util.Map<java.lang.String,​java.lang.String> headers)
        Deprecated.
        Retrieves the field name from the Content-disposition header.
        Parameters:
        headers - A Map containing the HTTP request headers.
        Returns:
        The field name for the current encapsulation.
      • createItem

        @Deprecated
        protected FileItem createItem​(java.util.Map<java.lang.String,​java.lang.String> headers,
                                      boolean isFormField)
                               throws FileUploadException
        Deprecated.
        1.2 This method is no longer used in favour of internally created instances of FileItem.
        Creates a new FileItem instance.
        Parameters:
        headers - A Map containing the HTTP request headers.
        isFormField - Whether or not this item is a form field, as opposed to a file.
        Returns:
        A newly created FileItem instance.
        Throws:
        FileUploadException - if an error occurs.
      • getParsedHeaders

        protected FileItemHeaders getParsedHeaders​(java.lang.String headerPart)

        Parses the header-part and returns as key/value pairs.

        If there are multiple headers of the same names, the name will map to a comma-separated list containing the values.

        Parameters:
        headerPart - The header-part of the current encapsulation.
        Returns:
        A Map containing the parsed HTTP request headers.
      • parseHeaders

        @Deprecated
        protected java.util.Map<java.lang.String,​java.lang.String> parseHeaders​(java.lang.String headerPart)
        Deprecated.

        Parses the header-part and returns as key/value pairs.

        If there are multiple headers of the same names, the name will map to a comma-separated list containing the values.

        Parameters:
        headerPart - The header-part of the current encapsulation.
        Returns:
        A Map containing the parsed HTTP request headers.
      • getHeader

        @Deprecated
        protected final java.lang.String getHeader​(java.util.Map<java.lang.String,​java.lang.String> headers,
                                                   java.lang.String name)
        Deprecated.
        Returns the header with the specified name from the supplied map. The header lookup is case-insensitive.
        Parameters:
        headers - A Map containing the HTTP request headers.
        name - The name of the header to return.
        Returns:
        The value of specified header, or a comma-separated list if there were multiple headers of that name.
      • setProgressListener

        public void setProgressListener​(ProgressListener pListener)
        Sets the progress listener.
        Parameters:
        pListener - The progress listener, if any. Defaults to null.