Struts <html:optionsCollection> Tag

The <html:optionsCollection> tag renders a set of HTML <option> elements, representing possible choices for a <select> element. This tag can be used multiple times within a single <html:select> element, either in conjunction with or instead of one or more <html:option> or <html:options> elements.

<%@taglib uri="/WEB-INF/struts-html.tld" prefix="html" %> 

First create a new Dynamic Web Project and configure it as Maven Project. For Reference, Click Here

Add the following dependencies in pom.xml


1. Create JSP

Now we will create a HTML dropdown using Struts’s HTML tag

Write the following code in dropdown.jsp

<%@taglib uri="" prefix="html"%>
<title>Struts <Html:optionsCollection> OptionsCollection Tag</title>
<html:form action="/dropdown">
    Fruit : 
    <html:select property="fruit" value="Select">
        <html:option value="Select">Select</html:option>
        <html:optionsCollection name="StrutsDropDownForm" property="fruitList" label="label" value="value" />

Now create another JSP output.jsp that displays dropdown value. Write the following code in output.jsp

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@ taglib uri="" prefix="bean"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
        <title>Output Page</title>
       Selected Fruit - <bean:write name="StrutsDropDownForm" property="fruit" />

2. Action Form

Create a Action Form class and name it that contains the following code.

package com.kruders.form;
import java.util.ArrayList;
import org.apache.struts.action.ActionForm;
import org.apache.struts.util.LabelValueBean;
public class StrutsDropDownForm extends ActionForm{
    private static final long serialVersionUID = 1L;
    private String fruit;
    ArrayList fruitList = new ArrayList();
    public String getFruit() {
        return fruit;
    public void setFruit(String fruit) {
        this.fruit = fruit;
    public ArrayList getFruitList() {
        fruitList.add(new LabelValueBean("Apple", "Apple"));
        fruitList.add(new LabelValueBean("Mango", "Mango"));
        return fruitList;
    public void setFruitList(ArrayList fruitList) {
        this.fruitList = fruitList;

If we have only label and value then we can use the LabelValueBean class to add the label and value to the ArrayList.

fruitList.add(new LabelValueBean("Apple", "Apple"));
fruitList.add(new LabelValueBean("Mango", "Mango"));

You can display fruit list in JSP Page like this

<html:optionsCollection name="StrutsDropDownForm" property="fruitList" label="label" value="value" /> 

We can also create a separate class for Fruit and add it to ArrayList as shown below.

Fruit Class can be like this

public class Fruit {
    private String fruitId;
    private String fruitName;
    public String getFruitId() {
        return fruitId;
    public void setFruitId(String fruitId) {
        this.fruitId = fruitId;
    public String getFruitName() {
        return fruitName;
    public void setFruitName(String fruitName) {
        this.fruitName = fruitName;

You can add Fruit object inside ArrayList like this

fruitList.add(new Fruit("1", "Apple"));
fruitList.add(new Fruit("2", "Mango"));

You can display fruit list in JSP Page like this

<html:optionsCollection name="StrutsDropDownForm" property="fruitList" label="fruitName" value="fruitId" /> 

3. Action Class (Controller)

Let us create an Action class that will handles and forward the request.

package com.kruders.action;
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;
public class StrutsDropDownAction extends Action{
    public ActionForward execute(ActionMapping mapping,ActionForm form,
        HttpServletRequest request, HttpServletResponse response)
                throws Exception {
        return mapping.findForward("success");

4. Struts Config

Write the following code in struts-config.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts-config PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 1.3//EN" 
        <form-bean name="StrutsDropDownForm" type="com.kruders.form.StrutsDropDownForm"/>
        <forward name="dropdown" path="/"/>
        <action input="/dropdown.jsp" name="StrutsDropDownForm" path="/dropdown"  validate="true" scope="request" type="com.kruders.action.StrutsDropDownAction">
            <forward name="success" path="/output.jsp" />

5. Deployment Descriptor

Now configure the deployment descriptor. Here, we have asked the container to give our ActionServlet any request that matches the pattern *.do

Add the following configuration information in the web.xml file


6. Run Project

Now when you run the project, following screen will be displayed as shown in Figure 30.1

Figure 30.1 Figure 30.1

Now when you select any value in dropdown and click submit button, following screen will be displayed as shown in Figure 30.2

Figure 30.2 Figure 30.2

The folder structure of the example is shown below in Figure 30.3

Figure 30.3 Figure 30.3

You can download the source code of this example here.


One Response to Struts <html:optionsCollection> Tag