{"id":246,"date":"2007-09-19T00:00:00","date_gmt":"2007-09-19T00:00:00","guid":{"rendered":"http:\/\/www.strongd.net\/?p=246"},"modified":"2007-09-19T00:00:00","modified_gmt":"2007-09-19T00:00:00","slug":"Handling Form-based File Upload with Java Servlet or JSP","status":"publish","type":"post","link":"https:\/\/www.strongd.net\/?p=246","title":{"rendered":"Handling Form-based File Upload with Java Servlet or JSP"},"content":{"rendered":"

Unlike PHP, Java Servlet and JSP do not have build-in mechanisms for handling form-based file uploads. One solution to this problem is to implement a function yourself to extract uploaded files contained in an HTTP request. However, a better choice is to make use of a third-party library that can help us handle file uploads.<\/SPAN><\/P>

One robust library available is the Apache Jakarta Commons FileUpload package. It is open-source and can be downloaded free of charge over the Internet. We will demonstrate how to use the Apache Jakarta Commons FileUpload package to extract uploaded files submitted from a form. The techniques are the same for HTML and XHTML. If you are not familiar with JSP or Java Servlet, you may want to read some introductory tutorials before going through this section.<\/SPAN><\/P>

At the time of writing, the most up-to-date version of the Apache Jakarta Commons FileUpload library is 1.1.1. So, we assume you are using Commons FileUpload 1.1.1 in this tutorial. For other versions of Commons FileUpload, the procedures may be slightly different but the principle is the same.<\/SPAN><\/P>


<\/P>

<\/A>Downloading the Apache Jakarta Commons FileUpload and Commons IO Libraries<\/H2>

To download the Apache Jakarta Commons FileUpload library, go to the home page of the Apache Jakarta Commons FileUpload project<\/A> and navigate to the download section. The binaries are available in two file formats: zip format and tar-gzip format. Download either one of them and uncompress the file. Then go to the home page of the Apache Jakarta Commons IO project<\/A> and repeat the same steps. We need the Commons IO library since Commons FileUpload uses it internally. Now you have two JAR files, “commons-fileupload-version<\/I>.jar” and “commons-io-version<\/I>.jar”, where version<\/I> is the version number. At the time of writing, the latest version of the Commons FileUpload library and that of the Commons IO library are 1.1.1 and 1.2 respectively. So, the JAR files we obtain are “commons-fileupload-1.1.1.jar” and “commons-io-1.2.jar”.<\/SPAN><\/P>


<\/P>

<\/A>Installing Apache Jakarta Commons FileUpload and Commons IO into a Servlet\/JSP Container Like Tomcat<\/H2>

Next, we need to install the Apache Jakarta Commons FileUpload library and the Apache Jakarta Commons IO library into a Servlet\/JSP container such as Apache Tomcat. To do this, copy the JAR files “commons-fileupload-1.1.1.jar” and “commons-io-1.2.jar” to the \/WEB-INF\/lib\/ directory in the document root of your web application.<\/SPAN><\/P>

Note that JAR libraries stored in \/WEB-INF\/lib\/ will be available to the containing web application only. If you want to share the libraries among all web applications installed in Tomcat (suppose you are using Tomcat 5 or Tomcat 4), the JAR files should be copied to the $CATALINA_HOME<\/I>\/shared\/lib\/ directory, where $CATALINA_HOME<\/I> is the root of your Tomcat installation.<\/SPAN><\/P>


<\/P>

<\/A>Checking If an HTTP Request is Encoded in Multipart Format<\/H2>

Now that you have installed the Apache Jakarta Commons FileUpload library, you can start writing the code. First, we have to make sure the HTTP request is encoded in multipart format. This can be done using the static method isMultipartContent()<\/I> of the ServletFileUpload<\/I> class of the org.apache.commons.fileupload.servlet<\/I> package:<\/SPAN><\/P>


<\/P>

if (ServletFileUpload.isMultipartContent(request)){
  \/\/ Parse the HTTP request…
}<\/SPAN><\/P>


<\/P>

In the above Java code snippet, request<\/I> is a javax.servlet.http.HttpServletRequest<\/I> object that encapsulates the HTTP request. It should be very familiar to you if you know Java Servlet or JSP.<\/SPAN><\/P>


<\/P>

<\/A>Parsing Form Data with Java Servlet \/ JSP<\/H2>

Second, we will parse the form data contained in the HTTP request. Parsing the form data is very straightforward with the Apache Jakarta Commons FileUpload library:<\/SPAN><\/P>


<\/P>

ServletFileUpload servletFileUpload = new ServletFileUpload(new DiskFileItemFactory());
List fileItemsList = servletFileUpload.parseRequest(request);<\/SPAN><\/P>


<\/P>

(In the above Java code snippet, DiskFileItemFactory<\/I> is a class contained in the org.apache.commons.fileupload.disk<\/I> package and List<\/I> is an interface contained in the java.util<\/I> package.)<\/SPAN><\/P>

If everything works fine, fileItemsList<\/I> will contain a list of file items that are instances of FileItem<\/I> of the org.apache.commons.fileupload<\/I> package. A file item may contain an uploaded file or a simple name-value pair of a form field. (More details about FileItem<\/I> will be provided later.)<\/SPAN><\/P>

By default, the ServletFileUpload<\/I> instance created by the above Java code uses the following values when parsing the HTTP request:<\/SPAN><\/P>