com.opensymphony.xwork2.validator.validators
Class StringLengthFieldValidator

java.lang.Object
  com.opensymphony.xwork2.validator.validators.ValidatorSupport
      com.opensymphony.xwork2.validator.validators.FieldValidatorSupport
          com.opensymphony.xwork2.validator.validators.StringLengthFieldValidator

All Implemented Interfaces:

FieldValidator, ShortCircuitableValidator, Validator

public class StringLengthFieldValidator
extends FieldValidatorSupport

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 trim the String before performing the length check. If unspecified, the String will be trimmed.

• 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

 
      <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">
                <field-validator type="stringlength">
                     <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-validator>
            </field>
      </validators>
 
 

Version:

$Date: 2008-06-11 12:20:19 +0200 (Mi, 11 Jun 2008) $ $Id: StringLengthFieldValidator.java 1786 2008-06-11 10:20:19Z rainerh $

Author:

Jason Carreira, Mark Woon, tmjee

Field Summary

Fields inherited from class com.opensymphony.xwork2.validator.validators.ValidatorSupport

defaultMessage, log, messageKey

Constructor Summary

StringLengthFieldValidator()

Method Summary

int	getMaxLength()
int	getMinLength()
boolean	getTrim()
void	setMaxLength(int maxLength)
void	setMinLength(int minLength)
void	setTrim(boolean trim)
void	validate(Object object) The validation implementation must guarantee that setValidatorContext will be called with a non-null ValidatorContext before validate is called.

Methods inherited from class com.opensymphony.xwork2.validator.validators.FieldValidatorSupport

getFieldName, getValidatorType, setFieldName, setValidatorType

Methods inherited from class com.opensymphony.xwork2.validator.validators.ValidatorSupport

addActionError, addFieldError, conditionalParse, getDefaultMessage, getFieldValue, getMessage, getMessageKey, getMessageParameters, getParse, getValidatorContext, isShortCircuit, setDefaultMessage, setMessageKey, setMessageParameters, setParse, setShortCircuit, setValidatorContext, setValueStack

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.opensymphony.xwork2.validator.Validator

getDefaultMessage, getMessage, getMessageKey, getMessageParameters, getValidatorContext, setDefaultMessage, setMessageKey, setMessageParameters, setValidatorContext, setValueStack

Constructor Detail

StringLengthFieldValidator

public StringLengthFieldValidator()

Method Detail

setMaxLength

public void setMaxLength(int maxLength)

getMaxLength

public int getMaxLength()

setMinLength

public void setMinLength(int minLength)

getMinLength

public int getMinLength()

setTrim

public void setTrim(boolean trim)

getTrim

public boolean getTrim()

validate

public void validate(Object object)
              throws ValidationException

Description copied from interface: Validator

The validation implementation must guarantee that setValidatorContext will be called with a non-null ValidatorContext before validate is called.

Parameters:

object - the object to be validated.

Throws:

ValidationException - is thrown if there is validation error(s).