com.opensymphony.xwork2.validator.validators
Class ValidatorSupport

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

All Implemented Interfaces:

ShortCircuitableValidator, Validator

Direct Known Subclasses:

ExpressionValidator, FieldValidatorSupport

public abstract class ValidatorSupport
extends Object
implements Validator, ShortCircuitableValidator

Abstract implementation of the Validator interface suitable for subclassing.

Author:

Jason Carreira, tm_jee, Martin Gilday

Field Summary

protected String	defaultMessage
protected Logger	log
protected String	messageKey

Constructor Summary

ValidatorSupport()

Method Summary

protected void	addActionError(Object object)
protected void	addFieldError(String propertyName, Object object)
protected Object	conditionalParse(String expression) Parse expression passed in against value stack.
String	getDefaultMessage() Gets the default message used for validation failures
protected Object	getFieldValue(String name, Object object) Return the field value named name from object, object should have the appropriate getter/setter.
String	getMessage(Object object) Gets the validation failure message for the given object
String	getMessageKey() Gets the resource bundle key used for lookup of validation failure message
String[]	getMessageParameters() Gets the messsage parameters to be used when parsing i18n messages
boolean	getParse()
ValidatorContext	getValidatorContext() Gets the validation context used
String	getValidatorType() Gets the vaildator type used (see class javadoc).
boolean	isShortCircuit() Gets whether this field validator should short circuit the validator queue it's in if validation fails.
void	setDefaultMessage(String message) Sets the default message to use for validation failure
void	setMessageKey(String key) Sets a resource bundle key to be used for lookup of validation failure message
void	setMessageParameters(String[] messageParameters) Sets the messsage parameters to be used when parsing i18n messages
void	setParse(boolean parse)
void	setShortCircuit(boolean shortcircuit) Sets whether this field validator should short circuit the validator queue it's in if validation fails.
void	setValidatorContext(ValidatorContext validatorContext) This method will be called before validate with a non-null ValidatorContext.
void	setValidatorType(String type) Sets the validator type to use (see class javadoc).
void	setValueStack(ValueStack stack) Sets the value stack to use to resolve values and parameters

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

validate

Field Detail

log

protected final Logger log

defaultMessage

protected String defaultMessage

messageKey

protected String messageKey

Constructor Detail

ValidatorSupport

public ValidatorSupport()

Method Detail

setValueStack

public void setValueStack(ValueStack stack)

Description copied from interface: Validator

Sets the value stack to use to resolve values and parameters

Specified by:

setValueStack in interface Validator

Parameters:

stack - The value stack for the request

setDefaultMessage

public void setDefaultMessage(String message)

Description copied from interface: Validator

Sets the default message to use for validation failure

Specified by:

setDefaultMessage in interface Validator

Parameters:

message - the default message

getDefaultMessage

public String getDefaultMessage()

Description copied from interface: Validator

Gets the default message used for validation failures

Specified by:

getDefaultMessage in interface Validator

Returns:

the default message

setParse

public void setParse(boolean parse)

getParse

public boolean getParse()

getMessage

public String getMessage(Object object)

Description copied from interface: Validator

Gets the validation failure message for the given object

Specified by:

getMessage in interface Validator

Parameters:

object - object being validated (eg. a domain model object)

Returns:

the validation failure message

setMessageKey

public void setMessageKey(String key)

Description copied from interface: Validator

Sets a resource bundle key to be used for lookup of validation failure message

Specified by:

setMessageKey in interface Validator

Parameters:

key - the resource bundle key

getMessageKey

public String getMessageKey()

Description copied from interface: Validator

Gets the resource bundle key used for lookup of validation failure message

Specified by:

getMessageKey in interface Validator

Returns:

the resource bundle key

getMessageParameters

public String[] getMessageParameters()

Description copied from interface: Validator

Gets the messsage parameters to be used when parsing i18n messages

Specified by:

getMessageParameters in interface Validator

Returns:

the messsage parameters

setMessageParameters

public void setMessageParameters(String[] messageParameters)

Description copied from interface: Validator

Sets the messsage parameters to be used when parsing i18n messages

Specified by:

setMessageParameters in interface Validator

Parameters:

messageParameters - the messsage parameters

setShortCircuit

public void setShortCircuit(boolean shortcircuit)

Description copied from interface: ShortCircuitableValidator

Sets whether this field validator should short circuit the validator queue it's in if validation fails.

Specified by:

setShortCircuit in interface ShortCircuitableValidator

Parameters:

shortcircuit - true if this field validator should short circuit on failure, false otherwise

isShortCircuit

public boolean isShortCircuit()

Description copied from interface: ShortCircuitableValidator

Gets whether this field validator should short circuit the validator queue it's in if validation fails.

Specified by:

isShortCircuit in interface ShortCircuitableValidator

Returns:

true if this field validator should short circuit on failure, false otherwise

setValidatorContext

public void setValidatorContext(ValidatorContext validatorContext)

Description copied from interface: Validator

This method will be called before validate with a non-null ValidatorContext.

Specified by:

setValidatorContext in interface Validator

Parameters:

validatorContext - the validation context to use.

getValidatorContext

public ValidatorContext getValidatorContext()

Description copied from interface: Validator

Gets the validation context used

Specified by:

getValidatorContext in interface Validator

Returns:

the validation context

setValidatorType

public void setValidatorType(String type)

Description copied from interface: Validator

Sets the validator type to use (see class javadoc).

Specified by:

setValidatorType in interface Validator

Parameters:

type - the type to use.

getValidatorType

public String getValidatorType()

Description copied from interface: Validator

Gets the vaildator type used (see class javadoc).

Specified by:

getValidatorType in interface Validator

Returns:

the type used

conditionalParse

protected Object conditionalParse(String expression)

Parse expression passed in against value stack. Only parse when 'parse' param is set to true, else just returns the expression unparsed.

Parameters:

expression -

Returns:

Object

getFieldValue

protected Object getFieldValue(String name,
                               Object object)
                        throws ValidationException

Return the field value named name from object, object should have the appropriate getter/setter.

Parameters:

name -

object -

Returns:

Object as field value

Throws:

ValidationException

addActionError

protected void addActionError(Object object)

addFieldError

protected void addFieldError(String propertyName,
                             Object object)