Apache Struts 2 Documentation > Home > Guides > Core Developers Guide > Validation > stringlength validator |

Apache Struts 2 Documentation
stringlength validator
Edit Page Browse Space Add Page Add News
Added by tm_jee, last edited by Philip Luppens on Feb 10, 2007 (view change) show comment hide comment
Comment: Fixed macro url
View page history

# Description

StringLengthFieldValidator checks that a String field is of a certain length. If the "minLength" parameter is specified, it will make sure that the String has at least that many characters. If the "maxLength" parameter is specified, it will make sure that the String has at most that many characters. The "trim" parameter determines whether it will {@link String#trim() trim} the String before performing the length check. If unspecified, the String will be trimmed.

# Parameters

- fieldName - The field name this validator is validating. Required if using Plain-Validator Syntax otherwise not required
- maxLength - The max length of the field value. Default ignore.
- minLength - The min length of the field value. Default ignore.
- trim - Trim the field value before evaluating its min/max length. Default true

# Examples

    <validators>
             <!-- Plain Validator Syntax -->
    			<validator type="stringlength">
    				<param name="fieldName">myPurchaseCode</param>
    				<param name="minLength">10</param>
                 <param name="maxLength">10</param>
                 <param name="trim">true</param>
                 <message>Your purchase code needs to be 10 characters long</message>
             </validator>

    			<!-- Field Validator Syntax -->
    			<field name="myPurchaseCode">
    				<param name="minLength">10</param>
                 <param name="maxLength>10</param>
                 <param name="trim">true</param>
                 <message>Your purchase code needs to be 10 characters long</message>
    			</field-name>
         </validators>