DoubleValidator (Apache Commons Validator 1.7 API)

java.lang.Object
- org.apache.commons.validator.routines.AbstractFormatValidator
- - org.apache.commons.validator.routines.AbstractNumberValidator
  - - org.apache.commons.validator.routines.DoubleValidator

All Implemented Interfaces:

Serializable
```
public class DoubleValidator
extends AbstractNumberValidator
```
Double Validation and Conversion routines (java.lang.Double).

This validator provides a number of methods for validating/converting a String value to a Double using java.text.NumberFormat to parse either:
- using the default format for the default Locale
- using a specified pattern with the default Locale
- using the default format for a specified Locale
- using a specified pattern with a specified Locale
Use one of the isValid() methods to just validate or one of the validate() methods to validate and receive a converted Double value.

Once a value has been successfully converted the following methods can be used to perform minimum, maximum and range checks:
- minValue() checks whether the value is greater than or equal to a specified minimum.
- maxValue() checks whether the value is less than or equal to a specified maximum.
- isInRange() checks whether the value is within a specified range of values.
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:
- using the default format for the default Locale
- using a specified pattern with the default Locale
- using the default format for a specified Locale
- using a specified pattern with a specified Locale
Since:

Validator 1.3.0

Version:

$Revision$

See Also:

Serialized Form

Field Summary
- Fields inherited from class org.apache.commons.validator.routines.AbstractNumberValidator
  CURRENCY_FORMAT, PERCENT_FORMAT, STANDARD_FORMAT

Constructor Summary

Constructors
Constructor and Description
`DoubleValidator()` Construct a strict instance.
`DoubleValidator(boolean strict, int formatType)` Construct an instance with the specified strict setting and format type.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static DoubleValidator`	`getInstance()` Return a singleton instance of this validator.
`boolean`	`isInRange(double value, double min, double max)` Check if the value is within a specified range.
`boolean`	`isInRange(Double value, double min, double max)` Check if the value is within a specified range.
`boolean`	`maxValue(double value, double max)` Check if the value is less than or equal to a maximum.
`boolean`	`maxValue(Double value, double max)` Check if the value is less than or equal to a maximum.
`boolean`	`minValue(double value, double min)` Check if the value is greater than or equal to a minimum.
`boolean`	`minValue(Double value, double min)` Check if the value is greater than or equal to a minimum.
`protected Object`	`processParsedValue(Object value, Format formatter)` Convert the parsed value to a `Double`.
`Double`	`validate(String value)` Validate/convert a `Double` using the default `Locale`.
`Double`	`validate(String value, Locale locale)` Validate/convert a `Double` using the specified `Locale`.
`Double`	`validate(String value, String pattern)` Validate/convert a `Double` using the specified pattern.
`Double`	`validate(String value, String pattern, Locale locale)` Validate/convert a `Double` 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
  - DoubleValidator
```
public DoubleValidator()
```
    Construct a strict instance.
  - DoubleValidator
```
public DoubleValidator(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:
    - AbstractNumberValidator.STANDARD_FORMAT -to create standard number formats (the default).
    - AbstractNumberValidator.CURRENCY_FORMAT -to create currency number formats.
    - AbstractNumberValidator.PERCENT_FORMAT -to create percent number formats (the default).
    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 DoubleValidator getInstance()
```
    Return a singleton instance of this validator.
    
    Returns:
    
    A singleton instance of the DoubleValidator.
  - validate
```
public Double validate(String value)
```
    Validate/convert a Double using the default Locale.
    
    Parameters:
    
    value - The value validation is being performed on.
    
    Returns:
    
    The parsed Double if valid or null if invalid.
  - validate
```
public Double validate(String value,
                       String pattern)
```
    Validate/convert a Double 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 BigDecimal if valid or null if invalid.
  - validate
```
public Double validate(String value,
                       Locale locale)
```
    Validate/convert a Double 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 Double if valid or null if invalid.
  - validate
```
public Double validate(String value,
                       String pattern,
                       Locale locale)
```
    Validate/convert a Double 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 Double if valid or null if invalid.
  - isInRange
```
public boolean isInRange(double value,
                         double min,
                         double 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(Double value,
                         double min,
                         double 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(double value,
                        double 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(Double value,
                        double 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(double value,
                        double 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(Double value,
                        double 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)
```
    Convert the parsed value to a Double.
    
    Specified by:
    
    processParsedValue in class AbstractNumberValidator
    
    Parameters:
    
    value - The parsed Number object created.
    
    formatter - The Format used to parse the value with.
    
    Returns:
    
    The validated/converted Double value if valid or null if invalid.

Class DoubleValidator

Field Summary

Fields inherited from class org.apache.commons.validator.routines.AbstractNumberValidator

Constructor Summary

Method Summary

Methods inherited from class org.apache.commons.validator.routines.AbstractNumberValidator

Methods inherited from class org.apache.commons.validator.routines.AbstractFormatValidator

Methods inherited from class java.lang.Object

Constructor Detail

DoubleValidator

DoubleValidator

Method Detail

getInstance

validate

validate

validate

validate

isInRange

isInRange

minValue

minValue

maxValue

maxValue

processParsedValue