Struts 2 s:checkbox and s:checkboxlist UI tag

by

<s:checkbox>:

The <s:checkbox> tag is used to create a HTML checkbox.

Syntax: <s:checkbox name=”fieldName” fieldValue=”true/false” label=”fieldLabel”/>

<s:checkboxlist>:

The <s:checkboxlist> tag is used to create the multiple checkbox with the same name.
Syntax: 

<s:checkboxlist label="fieldLabel" list="valueList" name="fieldName" value="defaultValue" />

Note: Multiple selected values can be stored in a String array or String object. In case of string object values will be comma separated. 

Example:

index.jsp

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
  	<title>
          Struts 2 s:checkbox and s:checkboxlist UI tags example
        </title>
	<META HTTP-EQUIV="Refresh" CONTENT="0;URL=initializeList.action">
  </head>  
  <body>
  </body>
</html>

test.jsp

<%@ taglib uri="/struts-tags" prefix="s"%>
<html>
	<head>
		<title>
                 Struts 2 s:checkbox and s:checkboxlist UI tags example
                </title>
	</head>
	<body>
		<h3>
                  This is a s:checkbox and s:checkboxlist UI tags example.
                </h3>
 
		<s:form action="Test">
		 <s:checkboxlist label="Select subjects" list="subjectList"
			name="selectedSubject" value="defaultSubject" />
		 <s:checkbox name="joinUs" label="Join Us"/>
		 <s:submit value="Submit"/>
		</s:form>
	</body>
</html>

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" 
	xmlns="http://java.sun.com/xml/ns/javaee" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
	http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
 
 
 	<filter>
	  <filter-name>struts2</filter-name>
	  <filter-class>
        	org.apache.struts2.dispatcher.ng.
        	filter.StrutsPrepareAndExecuteFilter
          </filter-class>
	</filter>
 
	<filter-mapping>
		<filter-name>struts2</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>
 
	<welcome-file-list>
	  <welcome-file>index.jsp</welcome-file>
	</welcome-file-list>
 
</web-app>

struts.xml

<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
 
<struts>
 
      <package name="default" extends="struts-default">
	<action name="initializeList" 
           class="com.w3schools.action.Test" method="initializeList">
		<result name="none">/test.jsp</result>
	</action>
 
	<action name="Test" class="com.w3schools.action.Test">
		<result name="success">/welcome.jsp</result>
	</action>
     </package>
 
</struts>

Test.java

import java.util.ArrayList;
import java.util.List;
import com.opensymphony.xwork2.ActionSupport;
 
/**
 * This class is used as an action class.
 * @author w3schools
 */
public class Test extends ActionSupport{
	//data members
	private List<String> subjectList;
	private String selectedSubject;
	private boolean joinUs;
 
	//business logic
	public String execute(){
		return SUCCESS;	
	}
 
	//getter setters
	public List<String> getSubjectList() {
		return subjectList;
	}
 
	public void setSubjectList(List<String> subjectList) {
		this.subjectList = subjectList;
	}
 
	public String getSelectedSubject() {
		return selectedSubject;
	}
 
	public void setSelectedSubject(String selectedSubject) {
		this.selectedSubject = selectedSubject;
	}
 
	public boolean isJoinUs() {
		return joinUs;
	}
 
	public void setJoinUs(boolean joinUs) {
		this.joinUs = joinUs;
	}	
 
	public String getDefaultSubject() {
		return "Java";
	}
 
	public String initializeList(){
		subjectList = new ArrayList<String>();
		subjectList.add("Java");
		subjectList.add("DBMS");
		subjectList.add("Networking");
		return NONE;
	}	
 
}

welcome.jsp

<%@ taglib uri="/struts-tags" prefix="s"%>
<html>
	<head>
		<title>
                 Struts 2 s:checkbox and s:checkboxlist UI tags example
                </title>
	</head>
	<body>
		<h3>
                 This is a s:checkbox and s:checkboxlist UI tags example.
                </h3>
 
		Selected subjects: <s:property value="selectedSubject"/>
                <br/>		
		Join us: <s:property value="joinUs" />
 
	</body>
</html>

Output:

struts 32 first
 
Select Subjects.
struts 32 second
 
Click on Submit button.
struts 32 final
 
Download this example.
 
Next Topic: Struts 2 s:select UI tag with example.
Previous Topic: Struts s:radio 2 UI tag with example.