Meyyappan has posted 101 posts at DZone. View Full User Profile

Struts Client-Side JavaScript Validation Tutorial

06.15.2012
| 36586 views |
  • submit to reddit

Struts Validator Framework provides an easy-to-use mechanism for performing client-side validation. It's very useful to validate some fields on the client-side before sending the data to the server for processing. By this way we can ensure that the data send to the server is valid. Performing validations on the client-side save the user a round trip time to the server.

For each validation routine defined in the validation-rules.xml file Struts provides an optional JavaScript code that can run on the client-side to perform the same validation that takes place on the server side.

Let's take a login application for our example. Our LoginForm extends DynaValidatorForm.

<form-bean name="LoginForm" type="org.apache.struts.validator.DynaValidatorForm">
    <form-property name="userName" type="java.lang.String" />
    <form-property name="password" type="java.lang.String" />
</form-bean>

The following validations are defined in the validation.xml file.

<form name="LoginForm">
    <field property="userName" depends="required">
    	<arg key="LoginForm.userName"/>
    </field>
    <field property="password" depends="required,minlength">
        <arg0 key="LoginForm.password"/>
        <arg1 key="${var:minlength}" name="minlength" resource="false"/>
        <var>
            <var-name>minlength</var-name>
            <var-value>6</var-value>
        </var>
    </field>
</form>

To enable client-side validation you have to place the Struts HTML Tag Library's javascript tag in each jsp page for which you need to preform client-side validation.

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>JS Validation</title>
</head>
<body>
    <html:form action="/Login" onsubmit="validateLoginForm(this);">>
        <html:javascript formName="LoginForm" />
        User Name : <html:text name="LoginForm" property="userName" /> <br>
        Password  : <html:password name="LoginForm" property="password" /> <br>
        <html:submit value="Login" />
    </html:form>
</body>
</html>

The formName property of the javascript tag hold the name of the form specified in the validation.xml file.

Next step is to specify the onsubmit attribute of the HTML Tag Library's form tag. The onsubmit attribute is used to specify the javascript code that should be executed when the form is submitted.

The name of the validate method generated by the javascipt tag is formed by concatenating "validate" with the name of the form specified in the javascript. For example, our form name is "LoginForm" so the generated method name will be "validateLoginForm". If the form name is "loginForm", the generated method name will be "validateLoginForm"

Run the application. The login.jsp page will be displayed. Click the login button without entering the User Name and the Passowrd. The following error messages will be displayed to the user. By using the client-side javascript validation we can display the error messages on the alert box, instead of displaying it on the web page.

Enter only the user name and click the Login button. The following error message will be displayed.

Enter a User Name and a Password less than six characters. The following error message will be displayed.

Enter the User Name as "eswar" and a Password greater than six characters. The following success page will be displayed.

You can download the source code of the Struts Javascript validation example by clicking on the Download link below.

Source: Download

Source + Lib: Download

Published at DZone with permission of its author, Meyyappan Muthuraman.

(Note: Opinions expressed in this article and its replies are the opinions of their respective authors and not those of DZone, Inc.)

Tags: