Wednesday, November 5, 2014

File Upload using Servlets

Create a simple Dynamic Web project in the eclipse IDE. I have installed Apache Tomcat 7.0.10 and following is my folder stucture. You can safely skip the and files from this folder structure as they don't have any thing to do with this post.

My motive is to give a simple explanation/illustration on how a file upload control can be implemented in java programs using servlets.

Step 1. create a FileUploadTest.html file in your WebContent folder. I tried putting the same under a sub folder of the WebContent folder. But it never worked. It was not able to communicate with the corresponding servlet.
The code contents of this HTML file are as follows

Step 2: Create a servlet class with the following contents in it

package com.practise.karthik.servlet;

// Import required java libraries
import java.util.*;

import javax.servlet.ServletConfig;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

public class UploadServlet extends HttpServlet {
   private boolean isMultipart;
   private String filePath;
   private int maxFileSize = 50 * 1024;
   private int maxMemSize = 4 * 1024;
   private File file ;

   public void init( ){
      // Get the file location where it would be stored.
      filePath =
   public void doPost(HttpServletRequest request,
               HttpServletResponse response)
              throws ServletException, {
      // Check that we have a file upload request
      isMultipart = ServletFileUpload.isMultipartContent(request);
      response.setContentType("text/html"); out = response.getWriter( );
      if( !isMultipart ){
         out.println("<title>Servlet upload</title>");
         out.println("<p>No file uploaded</p>");
      DiskFileItemFactory factory = new DiskFileItemFactory();
      // maximum size that will be stored in memory
      // Location to save data that is larger than maxMemSize.
      factory.setRepository(new File("c:\\temp"));

      // Create a new file upload handler
      ServletFileUpload upload = new ServletFileUpload(factory);
      // maximum file size to be uploaded.
      upload.setSizeMax( maxFileSize );

      // Parse the request to get file items.
      List fileItems = upload.parseRequest(request);
      // Process the uploaded file items
      Iterator i = fileItems.iterator();

      out.println("<title>Servlet upload</title>");
      while ( i.hasNext () )
         FileItem fi = (FileItem);
         if ( !fi.isFormField () )
            // Get the uploaded file parameters
            String fieldName = fi.getFieldName();
            String fileName = fi.getName();
            String contentType = fi.getContentType();
            boolean isInMemory = fi.isInMemory();
            long sizeInBytes = fi.getSize();
            // Write the file
            if( fileName.lastIndexOf("\\") >= 0 ){
               file = new File( filePath +
               fileName.substring( fileName.lastIndexOf("\\"))) ;
               file = new File( filePath +
               fileName.substring(fileName.lastIndexOf("\\")+1)) ;
            fi.write( file ) ;
            out.println("Uploaded Filename: " + fileName + "<br>");
   }catch(Exception ex) {
   public void doGet(HttpServletRequest request,
                       HttpServletResponse response)
        throws ServletException, {
        throw new ServletException("GET method used with " +
                getClass( ).getName( )+": POST method required.");

Step 3: Add the following to your web.xml


Set 4 : Now you would need a couple of jar files that would help you with the file upload functionality

commons-fileupload.x.x.jar file - You can download it from
commons-io-x.x.jar file - You can download it from

Step 5: Download these files and add them to the lib folder under the WEB-INF folder and add it to the project's build path

Step 6: Now stop your Apache Tomcat Server if its already running. 
 - Right click on the html file mentioned in step 1, 
 - click on "Run as" and 
 - click on "Run on server" option
 - choose your installed Tomcat server ( hope you had already added the server to your Servers view in the eclipse) and
 - finish

This helped me get to the following screen

Choose your file and click on the "Upload File" button. You should receive a confirmation screen with the name of the file that you just uploaded as follows

This helped me upload my file to my server space configured in the web.xml and I am able to find the uploaded file as follows

1 comment:

  1. Thanks for the post, I am techno savvy. I believe you hit the nail right on the head.
    I am highly impressed with your blog. It is very nicely explained.
    Your article adds best knowledge to our Java Online Training from India. or learn thru Java Online Training from India Students.