Struts 2 Merge Tag Example

In this section, we are going to describe the merge tag. The merge tag is a generic tag that is used to merge iterators. The successive call to the merge iterator causes each merge iterator to have a chance to expose its element, subsequently next call allows the next iterator to expose its element. Once the last iterator is done exposing its element, the first iterator is allowed to do so again (unless it is exhausted of entries).

In the current example, 3 lists being merged, each list have 3 entries, the following will be the logic.

  • Display first element of the first list.
  • Display first element of the second list.
  • Display first element of the third list.
  • Display second element of the first list.
  • Display second element of the second list.
  • Display second element of the third list.
  • Display third element of the first list.
  • Display third element of the second list
  • Display third element of the third list…..and so on..

Create action classes:
First of all let us create a simple class called which looks like:

package com.dineshonjava.struts2.action;

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

import com.opensymphony.xwork2.ActionSupport;

 * @author Dinesh Rajput
public class ControlTagAction extends ActionSupport{

 private static final long serialVersionUID = 1L;
 private List<String> myList1 = new ArrayList<String>();
 private List<String> myList2 = new ArrayList<String>();
 private List<String> myList3 = new ArrayList<String>();
 public String execute() {
  myList1.add("dinesh in list 1");
  myList1.add("aadesh in list 1");
  myList1.add("vinesh in list 1");
  myList2.add("dinesh in list 2");
  myList2.add("aadesh in list 2");
  myList1.add("vinesh in list 2");
  myList3.add("dinesh in list 3");
  myList3.add("aadesh in list 3");
  myList1.add("vinesh in list 3");
  return SUCCESS;

 public List<String> getMyList1() {
  return myList1;

 public void setMyList1(List<String> myList1) {
  this.myList1 = myList1;

 public List<String> getMyList2() {
  return myList2;

 public void setMyList2(List<String> myList2) {
  this.myList2 = myList2;

 public List<String> getMyList3() {
  return myList3;

 public void setMyList3(List<String> myList3) {
  this.myList3 = myList3;


Create views
Create a file called merge.jsp with the following contents:

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

  <title>Merge Control Tag Struts2 |</title>
  <h1><span style="background-color: #FFFFcc">Merge Tag Example! |
  <s:merge id="mergeId">
  <s:param value="%{myList1}" />
  <s:param value="%{myList2}" />
  <s:param value="%{myList3}" />
  <s:iterator value="%{#mergeId}">
  <s:property /><br>

The merge tag takes two or more lists as parameters.

Configuration Files
Your struts.xml should look like:

<?xml version="1.0" encoding="UTF-8" ?>
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    <constant name="struts.enable.DynamicMethodInvocation" value="false" />
    <constant name="struts.devMode" value="false" />
    <constant name="struts.custom.i18n.resources" value="myapp" />
    <package name="default" extends="struts-default" namespace="/">
        <action name="mergetag" class="com.dineshonjava.struts2.action.ControlTagAction">
            <result name="success">/merge.jsp</result>

Your web.xml should look like:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="" xmlns="" xmlns:web="" xsi:schemaLocation="" id="WebApp_ID" version="3.0">

Right click on the project name and click Export > WAR File to create a War file. Then deploy this WAR in the Tomcat’s webapps directory. Finally, start Tomcat server and try to access

URL http://localhost:8080/doj/mergetag.

This will give you following screen:

Struts 2 Merge Tag Example

Download Source Code

<<Previous <<   || Index ||   >>Next >>