Package org.apache.wicket.validation.validator

Class AbstractRangeValidator<R extends java.lang.Comparable<? super R> & java.io.Serializable,V extends java.io.Serializable>

java.lang.Object

org.apache.wicket.behavior.Behavior

org.apache.wicket.validation.validator.AbstractRangeValidator<R,V>

Type Parameters:

R - type of range value

V - type of validatable

All Implemented Interfaces:

java.io.Serializable, IComponentAwareEventSink, IComponentAwareHeaderContributor, org.apache.wicket.util.io.IClusterable, IValidator<V>

Direct Known Subclasses:

RangeValidator, StringValidator

public abstract class AbstractRangeValidator<R extends java.lang.Comparable<? super R> & java.io.Serializable,V extends java.io.Serializable>
extends Behavior
implements IValidator<V>

Base class for validators that check if a given value falls within [min,max] range. If either min or max are null they are not checked.

Resource keys:

• <class.simpleName>.exact if min==max
• <class.simpleName>.range if both min and max are not null
• <class.simpleName>.minimum if max is null
• <class.simpleName>.maximum if min is null

Error Message Variables:

• name: the id of Component that failed
• label: the label of the Component (either comes from FormComponent.labelModel or resource key <form-id>.<form-component-id>
• input: the input value
• minimum: the minimum allowed value
• maximum: the maximum allowed value

Author:

igor

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AbstractRangeValidator.Mode	Validator mode

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractRangeValidator()	Constructor used for subclasses who want to set the range using setRange(Comparable, Comparable)
	AbstractRangeValidator(R minimum, R maximum)	Constructor that sets the minimum and maximum values.

Method Summary

Modifier and Type	Method	Description
protected IValidationError	decorate(IValidationError error, IValidatable<V> validatable)	Allows subclasses to decorate reported errors
R	getMaximum()	Gets the maximum value.
R	getMinimum()	Gets the minimum value.
AbstractRangeValidator.Mode	getMode()	Gets validation mode which is determined by whether min, max, or both values are provided
protected abstract R	getValue(IValidatable<V> validatable)	Gets the value that should be validated against the range
protected void	setRange(R minimum, R maximum)	Sets validator range
void	validate(IValidatable<V> validatable)	Validates the IValidatable instance.

Methods inherited from class org.apache.wicket.behavior.Behavior

afterRender, beforeRender, bind, canCallListener, detach, getStatelessHint, isEnabled, isTemporary, onAttribute, onComponentTag, onConfigure, onEvent, onException, onRemove, onTag, renderHead, unbind

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractRangeValidator

public AbstractRangeValidator(R minimum,
                              R maximum)

Constructor that sets the minimum and maximum values.

Parameters:

minimum - the minimum value

maximum - the maximum value

AbstractRangeValidator

protected AbstractRangeValidator()

Constructor used for subclasses who want to set the range using setRange(Comparable, Comparable)

Method Detail

setRange

protected final void setRange(R minimum,
                              R maximum)

Sets validator range

Parameters:

minimum -

maximum -

validate

public void validate(IValidatable<V> validatable)

Description copied from interface: IValidator

Validates the IValidatable instance. Validation errors should be reported using the IValidatable.error(IValidationError) method.

Specified by:

validate in interface IValidator<R extends java.lang.Comparable<? super R> & java.io.Serializable>

Parameters:

validatable - the IValidatable instance being validated

getValue

protected abstract R getValue(IValidatable<V> validatable)

Gets the value that should be validated against the range

Parameters:

validatable -

Returns:

value to validate

getMinimum

public R getMinimum()

Gets the minimum value.

Returns:

minimum value

getMaximum

public R getMaximum()

Gets the maximum value.

Returns:

maximum value

decorate

protected IValidationError decorate(IValidationError error,
                                    IValidatable<V> validatable)

Allows subclasses to decorate reported errors

Parameters:

error -

validatable -

Returns:

decorated error

getMode

public final AbstractRangeValidator.Mode getMode()

Gets validation mode which is determined by whether min, max, or both values are provided

Returns:

validation mode