Introduction to Standard Validator-Rules.xml

The Inbuilt validation in the Validator-Rules.xml

The table will describe the validator rules available with the validator-rules.xml file provided by the Struts Community.


Rule	Description
byte	Checks value contained by field can be converted to java byte type
byteLocale	Checks value contained by field can be converted to java byte type using the number formatting convention for the current locale.
creditCard	Checks for the valid card number supplied by major companies like VISA, MASTERCARD etc.
date	Checks value contained by field can be converted to java.util.Date.
double	Checks value contained by field can be converted to double primitive type.
doubleRange	Checks value contained by field can be fitted into the primitive double range or not.
email	Checks value contained by field can be properly formatted email address or not.
float	Checks value contained by field can be converted to float primitive type.
floatLocale	Checks value contained by field can be converted to java float type using the number formatting convention for the current locale.
floatRange	Checks value contained by field can be fitted into the primitive float range or not.
integer	Checks value contained by field can be converted to int primitive type.
integerLocale	Checks value contained by field can be converted to java int type using the number formatting convention for the current locale.
intRange	Checks value contained by field can be fitted into the primitive int range or not.
long	Checks value contained by field can be converted to long primitive type.
longLocale	Checks value contained by field can be converted to java long type using the number formatting convention for the current locale.
longRange	Checks value contained by field can be fitted into the primitive long range or not.
mask	Validate the value with the given Regular Expression.
maxLength	Validate the maximum length should not be exceeded of the value with the value given in the property.
minLength	Validate the minimum length should not be exceeded of the value with the value given in the property.
required	Checks whether the value contain by the field is other than the whitespace.
short	Checks value contained by field can be converted to java short type
shortLocale	Checks value contained by field can be converted to java short type using the number formatting convention for the current locale.
url	Checks the given value is properly formatted URL or not.
validwhen	Determine the field is validated or not based on the specified test condition.

Standard validator-rules.xml file

The following is given the standard validator-rules.xml file. In the next section you will learn how to create your own validator rules. Till the time we are using the same validator-rules.xml which is the standard file comes with standard struts framework.

<!DOCTYPE form-validation PUBLIC "-//Apache Software Foundation//DTD Commons Validator Rules Configuration 1.3.0//EN" "http://jakarta.apache.org/commons/dtds/validator_1_3_0.dtd">

<!--

$Id: validator-rules.xml 481833 2006-12-03 17:32:52Z niallp $

This file contains the default Struts Validator pluggable validator definitions. It is contained in struts-core.jar, and should be referenced in the struts-config.xml under the plug-in element for the ValidatorPlugIn.

<plug-in className="org.apache.struts.validator.ValidatorPlugIn">

<set-property property="pathnames" value="/org/apache/struts/validator/validator-rules.xml, /WEB-INF/validation.xml"/>

</plug-in>

These are the default error messages associated with each validator defined in this file. They should be added to your projects ApplicationResources.properties file or you can associate new ones by modifying the pluggable validators msg attributes in this file.

# Struts Validator Error Messages

errors.required={0} is required.

errors.minlength={0} can not be less than {1} characters.

errors.maxlength={0} can not be greater than {1} characters.

errors.invalid={0} is invalid.

errors.byte={0} must be a byte.

errors.short={0} must be a short.

errors.integer={0} must be an integer.

errors.long={0} must be a long.

errors.float={0} must be a float.

errors.double={0} must be a double.

errors.date={0} is not a date.

errors.range={0} is not in the range {1} through {2}.

errors.creditcard={0} is an invalid credit card number.

errors.email={0} is an invalid e-mail address.

Note: Starting in Struts 1.2.0 the default javascript definitions have been consolidated to commons-validator. The default can be overridden

by supplying a <javascript> element with a CDATA section, just as in struts 1.1.

-->

<form-validation>

<validator name="includeJavaScriptUtilities"