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 :
Founder of, 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.
My website is hosted by Liquid Web, I really like their fast and helpful support, it saved me a lot of time. Furthermore, their servers are extremely reliable, fast and stable, I don't remember when was the last time we had server downtime. Btw, they're offering $100 Coupon now, if you are sourcing for great hosting provider, go grab it.

Related Posts

Popular Posts