javax.faces.validator
Class LongRangeValidator

java.lang.Object
  javax.faces.validator.ValidatorBase
      javax.faces.validator.LongRangeValidator

All Implemented Interfaces:

java.io.Serializable, Validator

public class LongRangeValidator

extends javax.faces.validator.ValidatorBase

LongRangeValidator is a Validator that checks the value of the corresponding component against specified minimum and maximum values. The following algorithm is implemented:

• Call getValue() to retrieve the current value of the component. If it is null, exit immediately. (If null values should not be allowed, a RequiredValidator can be configured to check for this case.)
• If the current component value is not a floating point type, or a String that is convertible to long, add a TYPE_MESSAGE_ID message to the FacesContext for this request, and skip subsequent checks.
• If a maximum property has been configured on this Validator, check the component value against this limit. If the component value is greater than the specified minimum, add a MAXIMUM_MESSAGE_ID message to the FacesContext for this request.
• If a minimum property has been configured on this Validator, check the component value against this limit. If the component value is less than the specified minimum, add a MINIMUM_MESSAGE_ID message to the FacesContext for this request.

See Also:

Serialized Form

Field Summary

static java.lang.String	MAXIMUM_MESSAGE_ID The message identifier of the Message to be created if the maximum value check fails.
static java.lang.String	MINIMUM_MESSAGE_ID The message identifier of the Message to be created if the minimum value check fails.
static java.lang.String	TYPE_MESSAGE_ID The message identifier of the Message to be created if the current value of this component is not of the correct type.

Constructor Summary

LongRangeValidator()
Construct a Validator with no preconfigured limits.

LongRangeValidator(long maximum)
Construct a Validator with the specified preconfigured limit.

LongRangeValidator(long maximum, long minimum)
Construct a Validator with the specified preconfigured limits.

Method Summary

protected double	doubleValue(java.lang.Object attributeValue) Return the specified attribute value, converted to a double.
long	getMaximum() Return the maximum value to be enforced by this Validator, if isMaximumSet() returns true.
protected Message	getMessage(FacesContext context, java.lang.String messageId) Return a Message for the specified parameters.
protected Message	getMessage(FacesContext context, java.lang.String messageId, java.lang.Object[] params) Return a Message for the specified parameters.
protected MessageResources	getMessageResources() Return the MessageResources instance for the message resources defined by the JavaServer Faces Specification.
long	getMinimum() Return the minimum value to be enforced by this Validator, if isMinimumSet() returns true.
boolean	isMaximumSet() Return a flag indicating whether a maximum limit has been set.
boolean	isMinimumSet() Return a flag indicating whether a minimum limit has been set.
protected long	longValue(java.lang.Object attributeValue) Return the specified attribute value, converted to a long.
void	setMaximum(long maximum) Set the maximum value to be enforced by this Validator.
void	setMinimum(long minimum) Set the minimum value to be enforced by this Validator.
protected java.lang.String	stringValue(java.lang.Object attributeValue) Return the specified attribute value, converted to a String.
void	validate(FacesContext context, UIComponent component) Perform the correctness checks implemented by this Validator against the specified UIComponent.

Methods inherited from class java.lang.Object

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

Field Detail

MAXIMUM_MESSAGE_ID

public static final java.lang.String MAXIMUM_MESSAGE_ID

The message identifier of the Message to be created if the maximum value check fails. The message format string for this message may optionally include a {0} placeholder, which will be replaced by the configured maximum value.

See Also:

Constant Field Values

MINIMUM_MESSAGE_ID

public static final java.lang.String MINIMUM_MESSAGE_ID

The message identifier of the Message to be created if the minimum value check fails. The message format string for this message may optionally include a {0} placeholder, which will be replaced by the configured minimum value.

See Also:

Constant Field Values

TYPE_MESSAGE_ID

public static final java.lang.String TYPE_MESSAGE_ID

The message identifier of the Message to be created if the current value of this component is not of the correct type.

See Also:

Constant Field Values

Constructor Detail

LongRangeValidator

public LongRangeValidator()

Construct a Validator with no preconfigured limits.

LongRangeValidator

public LongRangeValidator(long maximum)

Construct a Validator with the specified preconfigured limit.

Parameters:

maximum - Maximum value to allow

LongRangeValidator

public LongRangeValidator(long maximum,
                          long minimum)

Construct a Validator with the specified preconfigured limits.

Parameters:

maximum - Maximum value to allow

minimum - Minimum value to allow

Throws:

java.lang.IllegalArgumentException - if a specified maximum value is less than a specified minimum value

Method Detail

getMaximum

public long getMaximum()

Return the maximum value to be enforced by this Validator, if isMaximumSet() returns true.

setMaximum

public void setMaximum(long maximum)

Set the maximum value to be enforced by this Validator.

Parameters:

maximum - The new maximum value

Throws:

java.lang.IllegalArgumentException - if a specified maximum value is less than a specified minimum value

isMaximumSet

public boolean isMaximumSet()

Return a flag indicating whether a maximum limit has been set.

getMinimum

public long getMinimum()

Return the minimum value to be enforced by this Validator, if isMinimumSet() returns true.

setMinimum

public void setMinimum(long minimum)

Set the minimum value to be enforced by this Validator.

Parameters:

minimum - The new minimum value

Throws:

java.lang.IllegalArgumentException - if a specified maximum value is less than a specified minimum value

isMinimumSet

public boolean isMinimumSet()

Return a flag indicating whether a minimum limit has been set.

validate

public void validate(FacesContext context,
                     UIComponent component)

Description copied from interface: Validator

Perform the correctness checks implemented by this Validator against the specified UIComponent. If any violations are found:

• Add zero or more Messages to the specified FacesContext, specifying this UIComponent as associated with the message, describing the nature of the violation(s) encountered.
• Set the valid property on the specified UIComponent to false.

getMessage

protected Message getMessage(FacesContext context,
                             java.lang.String messageId)

Return a Message for the specified parameters.

Parameters:

context - The FacesContext associated with the request being processed

messageId - Message identifier of the requested message

getMessage

protected Message getMessage(FacesContext context,
                             java.lang.String messageId,
                             java.lang.Object[] params)

Return a Message for the specified parameters.

Parameters:

context - The FacesContext associated with the request being processed

messageId - Message identifier of the requested message

params - Substitution parameters for this message

getMessageResources

protected MessageResources getMessageResources()

Return the MessageResources instance for the message resources defined by the JavaServer Faces Specification.

doubleValue

protected double doubleValue(java.lang.Object attributeValue)
                      throws java.lang.NumberFormatException

Return the specified attribute value, converted to a double.

Parameters:

attributeValue - The attribute value to be converted

Throws:

java.lang.NumberFormatException - if conversion is not possible

longValue

protected long longValue(java.lang.Object attributeValue)
                  throws java.lang.NumberFormatException

Return the specified attribute value, converted to a long.

Parameters:

attributeValue - The attribute value to be converted

Throws:

java.lang.NumberFormatException - if conversion is not possible

stringValue

protected java.lang.String stringValue(java.lang.Object attributeValue)

Return the specified attribute value, converted to a String.

Parameters:

attributeValue - The attribute value to be converted