org.apache.commons.validator.routines
Class FloatValidator

java.lang.Object
  extended by org.apache.commons.validator.routines.AbstractFormatValidator
      extended by org.apache.commons.validator.routines.AbstractNumberValidator
          extended by org.apache.commons.validator.routines.FloatValidator
All Implemented Interfaces:
Serializable

public class FloatValidator
extends AbstractNumberValidator

Float Validation and Conversion routines (java.lang.Float).

This validator provides a number of methods for validating/converting a String value to a Float using java.text.NumberFormat to parse either:

Use one of the isValid() methods to just validate or one of the validate() methods to validate and receive a converted Float value.

Once a value has been sucessfully converted the following methods can be used to perform minimum, maximum and range checks:

So that the same mechanism used for parsing an input value for validation can be used to format output, corresponding format() methods are also provided. That is you can format either:

Since:
Validator 1.3.0
Version:
$Revision: 493905 $ $Date: 2007-01-08 03:11:38 +0100 (Mo, 08. Jan 2007) $
See Also:
Serialized Form

Field Summary
 
Fields inherited from class org.apache.commons.validator.routines.AbstractNumberValidator
CURRENCY_FORMAT, PERCENT_FORMAT, STANDARD_FORMAT
 
Constructor Summary
FloatValidator()
          Construct a strict instance.
FloatValidator(boolean strict, int formatType)
          Construct an instance with the specified strict setting and format type.
 
Method Summary
static FloatValidator getInstance()
          Return a singleton instance of this validator.
 boolean isInRange(float value, float min, float max)
          Check if the value is within a specified range.
 boolean isInRange(Float value, float min, float max)
          Check if the value is within a specified range.
 boolean maxValue(float value, float max)
          Check if the value is less than or equal to a maximum.
 boolean maxValue(Float value, float max)
          Check if the value is less than or equal to a maximum.
 boolean minValue(float value, float min)
          Check if the value is greater than or equal to a minimum.
 boolean minValue(Float value, float min)
          Check if the value is greater than or equal to a minimum.
protected  Object processParsedValue(Object value, Format formatter)
          Perform further validation and convert the Number to a Float.
 Float validate(String value)
          Validate/convert a Float using the default Locale.
 Float validate(String value, Locale locale)
          Validate/convert a Float using the specified Locale.
 Float validate(String value, String pattern)
          Validate/convert a Float using the specified pattern.
 Float validate(String value, String pattern, Locale locale)
          Validate/convert a Float using the specified pattern and/ or Locale.
 
Methods inherited from class org.apache.commons.validator.routines.AbstractNumberValidator
determineScale, getFormat, getFormat, getFormatType, isAllowFractions, isInRange, isValid, maxValue, minValue, parse
 
Methods inherited from class org.apache.commons.validator.routines.AbstractFormatValidator
format, format, format, format, format, isStrict, isValid, isValid, isValid, parse
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

FloatValidator

public FloatValidator()
Construct a strict instance.


FloatValidator

public FloatValidator(boolean strict,
                      int formatType)

Construct an instance with the specified strict setting and format type.

The formatType specified what type of NumberFormat is created - valid types are:

Parameters:
strict - true if strict Format parsing should be used.
formatType - The NumberFormat type to create for validation, default is STANDARD_FORMAT.
Method Detail

getInstance

public static FloatValidator getInstance()
Return a singleton instance of this validator.

Returns:
A singleton instance of the FloatValidator.

validate

public Float validate(String value)

Validate/convert a Float using the default Locale.

Parameters:
value - The value validation is being performed on.
Returns:
The parsed Float if valid or null if invalid.

validate

public Float validate(String value,
                      String pattern)

Validate/convert a Float using the specified pattern.

Parameters:
value - The value validation is being performed on.
pattern - The pattern used to validate the value against.
Returns:
The parsed Float if valid or null if invalid.

validate

public Float validate(String value,
                      Locale locale)

Validate/convert a Float using the specified Locale.

Parameters:
value - The value validation is being performed on.
locale - The locale to use for the number format, system default if null.
Returns:
The parsed Float if valid or null if invalid.

validate

public Float validate(String value,
                      String pattern,
                      Locale locale)

Validate/convert a Float using the specified pattern and/ or Locale.

Parameters:
value - The value validation is being performed on.
pattern - The pattern used to validate the value against, or the default for the Locale if null.
locale - The locale to use for the date format, system default if null.
Returns:
The parsed Float if valid or null if invalid.

isInRange

public boolean isInRange(float value,
                         float min,
                         float max)
Check if the value is within a specified range.

Parameters:
value - The Number value to check.
min - The minimum value of the range.
max - The maximum value of the range.
Returns:
true if the value is within the specified range.

isInRange

public boolean isInRange(Float value,
                         float min,
                         float max)
Check if the value is within a specified range.

Parameters:
value - The Number value to check.
min - The minimum value of the range.
max - The maximum value of the range.
Returns:
true if the value is within the specified range.

minValue

public boolean minValue(float value,
                        float min)
Check if the value is greater than or equal to a minimum.

Parameters:
value - The value validation is being performed on.
min - The minimum value.
Returns:
true if the value is greater than or equal to the minimum.

minValue

public boolean minValue(Float value,
                        float min)
Check if the value is greater than or equal to a minimum.

Parameters:
value - The value validation is being performed on.
min - The minimum value.
Returns:
true if the value is greater than or equal to the minimum.

maxValue

public boolean maxValue(float value,
                        float max)
Check if the value is less than or equal to a maximum.

Parameters:
value - The value validation is being performed on.
max - The maximum value.
Returns:
true if the value is less than or equal to the maximum.

maxValue

public boolean maxValue(Float value,
                        float max)
Check if the value is less than or equal to a maximum.

Parameters:
value - The value validation is being performed on.
max - The maximum value.
Returns:
true if the value is less than or equal to the maximum.

processParsedValue

protected Object processParsedValue(Object value,
                                    Format formatter)

Perform further validation and convert the Number to a Float.

Specified by:
processParsedValue in class AbstractNumberValidator
Parameters:
value - The parsed Number object created.
formatter - The Format used to parse the value with.
Returns:
The parsed Number converted to a Float if valid or null if invalid.


Copyright © 2002-2010 Apache Software Foundation. All Rights Reserved.