Struts File Upload Example

In this tutorial you will learn how to use Struts to write program to upload files.

Struts File Upload Example

Struts File Upload Example


In this tutorial you will learn how to use Struts to write program to upload files. The interface org.apache.struts.upload.FormFile is the heart of the struts file upload application. This interface represents a file that has been uploaded by a client. It is the only interface or class in upload package which is typically referenced directly by a Struts application.

Creating Form Bean

Our form bean class contains only one property theFile,  which is of type org.apache.struts.upload.FormFile.


Here is the code of FormBean (


import org.apache.struts.action.*;
import org.apache.struts.upload.FormFile;

@author Deepak Kumar
* @Web
* @Email [email protected]

 * Form bean for Struts File Upload.
public class StrutsUploadForm extends ActionForm
  private FormFile theFile;

 @return Returns the theFile.
  public FormFile getTheFile() {
  return theFile;
 @param theFile The FormFile to set.
  public void setTheFile(FormFile theFile) {
  this.theFile = theFile;

Creating Action Class

Our action class simply calls the getTheFile() function on the FormBean object to retrieve the reference of the uploaded file. Then the reference of the FormFile is used to get the uploaded file and its information. Here is the code of our action class(


import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.struts.action.Action;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;
import org.apache.struts.upload.FormFile;
@author Deepak Kumar
* @Web
* @Email [email protected]

 * Struts File Upload Action Form.
public class StrutsUploadAction extends Action
  public ActionForward execute(
  ActionMapping mapping,
  ActionForm form,
  HttpServletRequest request,
  HttpServletResponse responsethrows Exception{
  StrutsUploadForm myForm = (StrutsUploadForm)form;

  // Process the FormFile
  FormFile myFile = myForm.getTheFile();
  String contentType = myFile.getContentType();
  String fileName  = myFile.getFileName();
  int fileSize = myFile.getFileSize();
  byte[] fileData  = myFile.getFileData();
  System.out.println("contentType: " + contentType);
  System.out.println("File Name: " + fileName);
  System.out.println("File Size: " + fileSize);
  return mapping.findForward("success");

Defining form Bean in struts-config.xml file

Add the following entry in the struts-config.xml file for defining the form bean:


Defining Action Mapping

Add the following action mapping entry in the struts-config.xml file:

   <forward name="success" path="/pages/uploadsuccess.jsp"/>

Developing jsp page

Code of the jsp (FileUpload.jsp) file to upload is as follows:

<%@ taglib uri="/tags/struts-bean" prefix="bean" %>
<%@ taglib uri="/tags/struts-html" prefix="html" %>

<html:html locale="true">
<title>Struts File Upload Example</title>
<body bgcolor="white">
<html:form action="/FileUpload" method="post" enctype="multipart/form-data">
<td align="center" colspan="2">
<font size="4">Please Enter the Following Details</font>

<td align="left" colspan="2">
<font color="red"><html:errors/></font>

<td align="right">
File Name
<td align="left">
<html:file property="theFile"/> 

<td align="center" colspan="2">
<html:submit>Upload File</html:submit>


Note that we are setting the encrypt property of the form to enctype="multipart/form-data".

code for the success page (uploadsuccess.jsp) is:




<p align="center"><font size="5" >File Successfully Received</font></p>



Add the following line in the index.jsp to call the form.

<html:link page="/pages/FileUpload.jsp">Struts File Upload</html:link>
Example shows you how to Upload File with Struts.

Building Example and Testing

To build and deploy the application go to Struts\strutstutorial directory and type ant on the command prompt. This will deploy the application. Open the browser and navigate to the FileUpload.jsp page. Your browser should display the file upload form:



  1. Validations using Struts 2 Annotations
  2. Struts 1.1 Tutorials
  3. CRUD application in hibernate annotation
  4. Understanding Spring Struts Hibernate DAO Layer
  5. DAO Layer explained
  6. Developing Forgot Password Form
  7. Welcome to the Apache Struts Tutorial
  8. Developing Simple Struts Tiles Application
  9. Understanding Struts Controller
  10. Struts Hibernate Integration
  11. Developing Struts PlugIn
  12. Developing Struts Hibernate and Spring Based Login/Registration Application
  13. Struts File Upload and Save
  14. Struts 2 Features
  15. Struts 2 - History of Struts 2
  16. Struts 2 Architecture - Detail information on Struts 2 Architecture
  17. Download and Installing Struts 2
  18. Struts 2 Hello World Application Example, Learn how to develop Hello World application in struts 2.
  19. Developing JSP, Java and Configuration for Hello World Application
  20. Struts Configuration file - struts.xml
  21. Introduction to Struts 2 Tags
  22. Struts Logic Tags: An Introduction
  23. Logic Empty Tag (...)
  24. Logic Equal Tag (...)
  25. Logic greaterEqual Tag (... )
  26. Logic LessEqual Tag (...)
  27. Logic Match Tag (...)
  28. Logic Present Tag (...)
  29. Struts2 Actions
  30. Static Parameter
  31. Accessing Session Object
  32. Access Request and Response
  33. Control Tags-If / Else If / Else
  34. Append Tag (Control Tags) Example
  35. Generator Tag (Control Tags) Example
  36. Generator Tag (Control Tags) Using Count Attributes
  37. Generator Tag (Control Tags) Using an Iterator with Id Attributes
  38. Iterator Tag (Control Tags) Example
  39. Merge Tag (Control Tags) Example
  40. Subset Tag (Control Tags) Example