com.fedmest.cw.keyboard.validators
Class FloatValidator

java.lang.Object
  com.fedmest.cw.keyboard.validators.ValueTypeValidator<java.lang.Float>
      com.fedmest.cw.keyboard.validators.FloatValidator

All Implemented Interfaces:

KeyboardInputValidator<java.lang.Float>

public final class FloatValidator
extends ValueTypeValidator<java.lang.Float>

This class is used internally by the KeyboardUtils.readFloatFromKeyboard() methods. It is used as a singleton via getInstance(). There is really no need to use it other than through KeyboardUtils.

Version:

1.0

Author:

Federico Mestrone

Field Summary

Fields inherited from class com.fedmest.cw.keyboard.validators.ValueTypeValidator

errorMessage

Method Summary

java.lang.Float	cancelValue() Allows you to specify the return value to offer when the user cancels input on a cancelable instance of KeyboardUtils .
java.lang.Float	checkInput(java.lang.String txt) Takes the input string, checks its validity and converts it to the data type specified by the type argument.
static FloatValidator	getInstance() Returns the only available instance of this class
static void	resetMax() This method resets the maximum float value that will be accepted by this validator to the highest possible float value.
static void	resetMin() This method resets the minimum float value that will be accepted by this validator to the lowest possible float value.
static void	resetRange() This method resets the minimum and maximum float values that will be accepted by this validator to the lowest and highest possible float values respectively.
static void	resetRangeMessage() This method resets to the default text the error message that will be displayed to users when the value is out of range ("Value out of range - retry").
static void	setMax(float max) This method sets the maximum float value that will be accepted by this validator.
static void	setMin(float min) This method sets the minimum float value that will be accepted by this validator.
static void	setRange(float min, float max) This method sets the maximum and minimum float values that will be accepted by this validator.
static void	setRangeMessage(java.lang.String rangeMessage) This method sets the error message that will be displayed to the user if validation fails due to a value being outside of the range specified with setMax(float), setMin(float) or setRange(float, float).

Methods inherited from class com.fedmest.cw.keyboard.validators.ValueTypeValidator

resetErrorMessage, setErrorMessage

Methods inherited from class java.lang.Object

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

Method Detail

setRangeMessage

public static void setRangeMessage(java.lang.String rangeMessage)

This method sets the error message that will be displayed to the user if validation fails due to a value being outside of the range specified with setMax(float), setMin(float) or setRange(float, float). Invoke it before you call any method in KeyboardUtils that uses a class in this validator hierarchy to customize the error message that will be used. Note that the message applies to all subclasses of this class and will be used until reset with resetRangeMessage() or changed with this method again.

Parameters:

rangeMessage - the new error message to display to users

resetRangeMessage

public static void resetRangeMessage()

This method resets to the default text the error message that will be displayed to users when the value is out of range ("Value out of range - retry").

See Also:

setRangeMessage(String)

setMax

public static void setMax(float max)

This method sets the maximum float value that will be accepted by this validator. The value is inclusive. The validator will fail if the input value is greater than the value of the max parameter.

Parameters:

max - the maximum float value allowed in parsing (inclusive)

resetMax

public static void resetMax()

This method resets the maximum float value that will be accepted by this validator to the highest possible float value.

See Also:

setMax(float)

setMin

public static void setMin(float min)

This method sets the minimum float value that will be accepted by this validator. The value is inclusive. The validator will fail if the input value is less than the value of the min parameter.

Parameters:

min - the minimum float value allowed in parsing (inclusive)

resetMin

public static void resetMin()

This method resets the minimum float value that will be accepted by this validator to the lowest possible float value.

See Also:

setMin(float)

setRange

public static void setRange(float min,
                            float max)

This method sets the maximum and minimum float values that will be accepted by this validator. The values are inclusive. The validator will fail if the input value is not within the range specified by the min and max parameters. Invoking this method is equivalent to invoking setMin(float) and setMax(float).

Parameters:

min - the minimum float value allowed in parsing (inclusive)

max - the maximum float value allowed in parsing (inclusive)

See Also:

setMin(float), setMax(float)

resetRange

public static void resetRange()

This method resets the minimum and maximum float values that will be accepted by this validator to the lowest and highest possible float values respectively.

See Also:

setMin(float), setMax(float), resetMin(), resetMax()

getInstance

public static FloatValidator getInstance()

Returns the only available instance of this class

Returns:

the instance

checkInput

public java.lang.Float checkInput(java.lang.String txt)
                           throws KeyboardInputException

Description copied from interface: KeyboardInputValidator

Takes the input string, checks its validity and converts it to the data type specified by the type argument. If validation fails, a KeyboardInputException is raised and the user will have to type their input again. If a null reference is passed into the method, the method may throw a NullPointerException, so programmers do not need to worry about checking for null pointers.

Parameters:

txt - the input text. If the string is null, NullPointerException will be thrown.

Returns:

the result of converting the typed string into the data type expected

Throws:

KeyboardInputException - if validation against the input string failed

cancelValue

public java.lang.Float cancelValue()

Description copied from interface: KeyboardInputValidator

Allows you to specify the return value to offer when the user cancels input on a cancelable instance of KeyboardUtils . Though null should be returned in most cases, this method is useful when - for example - you want to return a primitive type from your validator and can't use null as a return value without causing a bit of inconvenienve in your application code (explicit unboxing and checks for null values).

Returns:

the value to return when user cancels input