Struts <html:checkbox> checkbox example

Download this Struts check box example –

In this Struts example, you will learn how to create a HTML check box input field with Struts <html:checkbox> tag

1. Folder Structure

This is the final project structure created by Maven. Please create the corresponding folders.

2. Action class

Create an Action class, do nothing but forward the request.

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

3. Properties file

Create a properties file, and declare the error and label messages.

#error message
error.common.html.checkbox.required = Please tick the checkbox.
#label message = CheckBox
label.common.html.checkbox.button.submit = Submit
label.common.html.checkbox.button.reset = Reset

4. ActionForm

Create a ActionForm, accept a checkbox value.

package com.mkyong.common.form;
import javax.servlet.http.HttpServletRequest;
import org.apache.struts.action.ActionErrors;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionMapping;
import org.apache.struts.action.ActionMessage;
public class HtmlCheckBoxForm extends ActionForm{
	String checkboxValue;
	public String getCheckboxValue() {
		return checkboxValue;
	public void setCheckboxValue(String checkboxValue) {
		this.checkboxValue = checkboxValue;
	public ActionErrors validate(ActionMapping mapping,
			HttpServletRequest request) {
	    ActionErrors errors = new ActionErrors();
	    if( getCheckboxValue() == null || ("".equals(getCheckboxValue()))) {
	    	  new ActionMessage("error.common.html.checkbox.required"));
	    return errors;
	public void reset(ActionMapping mapping, HttpServletRequest request) {
		// reset properties
		checkboxValue = "";

5. JSP Page

Use the Struts’s HTML tag <html:checkbox> to create a HTML checkbox input field.


<%@taglib uri="" prefix="html"%>
<%@taglib uri="" prefix="bean"%>
<h1>Struts html:checkbox example</h1>
<html:form action="/CheckBox">
<html:messages id="err_name" property="common.checkbox.err">
<div style="color:red">
	<bean:write name="err_name" />
<div style="padding:16px">
<bean:message key="" /> :
	<html:checkbox property="checkboxValue" />
<div style="padding:16px">
	<div style="float:left;padding-right:8px;">
                  <bean:message key="label.common.html.checkbox.button.submit" />
           <bean:message key="label.common.html.checkbox.button.reset" />

Display the check box value.


<%@taglib uri="" prefix="bean"%>
CheckBox value : <bean:write name="htmlCheckBoxForm" property="checkboxValue" />

6. struts-config.xml

Create a Struts configuration file and link all together.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts-config PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 1.3//EN" 
			<forward name="success" path="/pages/display.jsp"/>
		parameter="" />

7. web.xml

Final step, create a web.xml for the Strut framework integration.

 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "" >
  <display-name>Maven Struts Examples</display-name>

Access it


Tick the check box and pressed on the submit button, it will forward to


If a check box is selected, the value is “on”, else it’s an empty value.

Tags :

About the Author

Founder of and, love Java and open source stuff. Follow him on Twitter, or befriend him on Facebook or Google Plus. If you like my tutorials, consider make a donation to these charities.


  • Pingback: alkaline water brands()

  • Pingback: pay per day loan plans()

  • Pingback: laan penge online nu()

  • Pingback: water ionizer()

  • Pingback: parking()

  • Pingback: laan nu()

  • Pingback: youporn()

  • Pingback: car parking()

  • Pingback: DIRECTV channels()

  • Pingback: kangen()

  • Pingback: kangen water()

  • Pingback: best bottled water()

  • Pingback: water ionizers()

  • Pingback: stream movies()

  • Pingback: watch free movies online()

  • Pingback: free movie downloads()

  • Pingback: Blue Coaster33()

  • goods

    I must point out my affection for your kind-heartedness giving support to individuals that must have help on this important subject. Your personal dedication to passing the message up and down became quite significant and have continually helped associates much like me to achieve their aims. This interesting publication denotes so much to me and extremely more to my peers. Thanks a ton; from all of us.

  • http://Website,com Name

    To post source code in comment, uses tag, for examples :

    Java source code here
    XML here

  • http://Website,com Name


  • Pavan

    You can change the value, instead as “on”, if the checkbox is selected.
    use the attribute ‘value’.

    When selected, it’s value is ‘Y’ and empty if not selected.

  • Jimmy

    “If a check box is selected, the value is “on”, else it’s an empty value.”

    There is no default value for checkboxValue.
    checkboxValue isn’t assigned as “on” whatever it’s checked or not

  • Pingback: html:checkbox tutorials, descriptions « Hopbit's Dev Blog()