Over a million developers have joined DZone.

How to Iterate ArrayList in Struts2

DZone 's Guide to

How to Iterate ArrayList in Struts2

· Java Zone ·
Free Resource

We will discuss how to iterate over a collection of String objects in Struts2 tag libraries and then a List of custom class objects. It looks as if iterating a list of string objects is easier than iterating over a list of custom class objects in Struts 2. But the reality is that iterating a list of custom class objects is also equally easier. By custom class we mean the User, Employee, Department, Products, Vehicles classes that are created in any web application.

Download Working Sample Here

Usually it happens that one needs to fetch a list of records from database/files and then display it in the JSP. The module requiring this functionality could be Search, Listing users/departments/products etc.

The basic flow of struts2 web application goes like:
The user initiates the request from one page. This request is received by the interceptor which further invokes the Struts2 action. The action class fetches the records and stores in a list. This list is available to the next JSP using the public getter method.
Please note that the public getter method for the List is mandatory.

Once the List has been populated by Struts2 action class, the JSP then iterates over this List and displays the corresponding information. In the days gone by, one would store the List as a session attribute and then access the list in JSP using the scriptlets to display appropriate output to the users.

Here is a Struts2 sample application to iterate one String and one custom class objects List.
Though we are using the Struts2 tag library to iterate the list but JSTL can also be used for iteration.

Also if you are going to use  the code examples given below, use the following URL's to access the application:

Iterate a Custom class ArrayList in Struts2

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5">
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "http://struts.apache.org/dtds/struts-2.1.dtd">

<package name="default" extends="struts-default" >

<action name="index">
<result name="success">/home.jsp</result>
<action name="fetch" class="com.example.FetchAction">
<result name="success">/success.jsp</result>
<result name="failure">/failure.jsp</result>


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

Enter a user name to get the documents uploaded by that user.
<s:form name="fetch" theme="simple" action="fetch">
Username <s:textfield name="username" />
<s:submit value="Fetch Records" />


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


Documents uploaded by the user are:</br>
<s:iterator value="documents"><s:property value="name" /></br></s:iterator>
<%@taglib uri="/struts-tags" prefix="s" %>
<h3><s:property value="message" /></h3>
package com.example;

import java.util.ArrayList;
import java.util.List;

public class FetchAction {

private String username;
private String message;
private List documents = new ArrayList();

public List getDocuments() {
return documents;

public String getMessage() {
return message;
public void setMessage(String message) {
this.message = message;
public String getUsername() {
return username;
public void setUsername(String username) {
this.username = username;

public String execute() {

if( username != null) {
//logic to fetch the document list (say from database)
Document d1 = new Document();
Document d2 = new Document();
Document d3 = new Document();


return "success";
} else {
message="Unable to fetch";
return "failure";


package com.example;

public class Document {

private String name;

public String getName() {
return name;

public void setName(String name) {
this.name = name;


Iterate String List in Struts2

The way to iterate the a String list is similar with the only difference that the action class FetchAction.java now populates the name of documents into an ArrayList of String objects.

The code zip file containing the iteration over an ArrayList of  custom class object or bean can be downloaded at:

The URL to access this application will be:

The code zip file containing the iteration over an ArrayList of  string class object or bean can be downloaded at:

The URL to access this application will be:


From http://extreme-java.blogspot.com/2011/05/how-to-iterate-arraylist-in-struts2.html


Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}