Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  /*
   * Licensed to the Apache Software Foundation (ASF) under one or more
   * contributor license agreements.  See the NOTICE file distributed with
   * this work for additional information regarding copyright ownership.
   * The ASF licenses this file to You under the Apache License, Version 2.0
   * (the "License"); you may not use this file except in compliance with
   * the License.  You may obtain a copy of the License at
   *
   *      http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
 package org.apache.tomcat.util.http.fileupload.servlet;
 
 import java.util.List;
 
 

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(javax.servlet.http.HttpServletRequest) to acquire a list of org.apache.tomcat.util.http.fileupload.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.

Author(s):
Rafal Krzewski
Daniel Rall
Jason van Zyl
John McNally
Martin Cooper
Sean C. Sullivan
Version:
$Id: ServletFileUpload.java 981816 2010-08-03 10:44:58Z markt $
 
 public class ServletFileUpload extends FileUpload {
 
     // ---------------------------------------------------------- Class methods
 

    
Utility method that determines whether the request contains multipart content.

Parameters:
request The servlet request to be evaluated. Must be non-null.
Returns:
true if the request is multipart; false otherwise.
 
     public static final boolean isMultipartContent(
             HttpServletRequest request) {
         if (!"post".equals(request.getMethod().toLowerCase(.))) {
             return false;
         }
         String contentType = request.getContentType();
         if (contentType == null) {
             return false;
         }
         if (contentType.toLowerCase(.).startsWith()) {
             return true;
         }
         return false;
     }
 
 
     // ----------------------------------------------------------- Constructors
 

    
Constructs an uninitialised instance of this class. A factory must be configured, using setFileItemFactory(), before attempting to parse requests.

 
     public ServletFileUpload() {
         super();
     }


    
Constructs an instance of this class which uses the supplied factory to create FileItem instances.

Parameters:
fileItemFactory The factory to use for creating file items.
See also:
FileUpload.org.apache.tomcat.util.http.fileupload.FileUpload.()
    public ServletFileUpload(FileItemFactory fileItemFactory) {
        super(fileItemFactory);
    }
    // --------------------------------------------------------- Public methods


    
Processes an RFC 1867 compliant multipart/form-data stream.

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:
org.apache.tomcat.util.http.fileupload.FileUploadException if there are problems reading/parsing the request or storing files.
    public List<FileItemparseRequest(HttpServletRequest request)
    throws FileUploadException {
        return parseRequest(new ServletRequestContext(request));
    }


    
Processes an RFC 1867 compliant multipart/form-data stream.

Parameters:
request The servlet request to be parsed.
Returns:
An iterator to instances of FileItemStream parsed from the request, in the order that they were transmitted.
Throws:
org.apache.tomcat.util.http.fileupload.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.
    throws FileUploadExceptionIOException {
        return super.getItemIterator(new ServletRequestContext(request));
    }
New to GrepCode? Check out our FAQ X