Class PercentValidator
- java.lang.Object
-
- org.apache.commons.validator.routines.AbstractFormatValidator
-
- org.apache.commons.validator.routines.AbstractNumberValidator
-
- org.apache.commons.validator.routines.BigDecimalValidator
-
- org.apache.commons.validator.routines.PercentValidator
-
- All Implemented Interfaces:
java.io.Serializable
public class PercentValidator extends BigDecimalValidator
Percentage Validation and Conversion routines (
java.math.BigDecimal
).This is one implementation of a percent validator that has the following features:
- It is lenient about the the presence of the percent symbol
- It converts the percent to a
java.math.BigDecimal
However any of the number validators can be used for percent validation. For example, if you wanted a percent validator that converts to a
java.lang.Float
then you can simply instantiate anFloatValidator
with the appropriate format type:... = new FloatValidator(false, FloatValidator.PERCENT_FORMAT);
Pick the appropriate validator, depending on the type (i.e Float, Double or BigDecimal) you want the percent converted to. Please note, it makes no sense to use one of the validators that doesn't handle fractions (i.e. byte, short, integer, long and BigInteger) since percentages are converted to fractions (i.e
50%
is converted to0.5
).- Since:
- Validator 1.3.0
- Version:
- $Revision: 1713331 $
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description private static char
PERCENT_SYMBOL
DecimalFormat's percent (thousand multiplier) symbolprivate static java.math.BigDecimal
POINT_ZERO_ONE
private static long
serialVersionUID
private static PercentValidator
VALIDATOR
-
Fields inherited from class org.apache.commons.validator.routines.AbstractNumberValidator
CURRENCY_FORMAT, PERCENT_FORMAT, STANDARD_FORMAT
-
-
Constructor Summary
Constructors Constructor Description PercentValidator()
Construct a strict instance.PercentValidator(boolean strict)
Construct an instance with the specified strict setting.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static BigDecimalValidator
getInstance()
Return a singleton instance of this validator.protected java.lang.Object
parse(java.lang.String value, java.text.Format formatter)
Parse the value with the specifiedFormat
.-
Methods inherited from class org.apache.commons.validator.routines.BigDecimalValidator
isInRange, maxValue, minValue, processParsedValue, validate, validate, validate, validate
-
Methods inherited from class org.apache.commons.validator.routines.AbstractNumberValidator
determineScale, getFormat, getFormat, getFormatType, isAllowFractions, isInRange, isValid, maxValue, minValue, parse
-
-
-
-
Field Detail
-
serialVersionUID
private static final long serialVersionUID
- See Also:
- Constant Field Values
-
VALIDATOR
private static final PercentValidator VALIDATOR
-
PERCENT_SYMBOL
private static final char PERCENT_SYMBOL
DecimalFormat's percent (thousand multiplier) symbol- See Also:
- Constant Field Values
-
POINT_ZERO_ONE
private static final java.math.BigDecimal POINT_ZERO_ONE
-
-
Method Detail
-
getInstance
public static BigDecimalValidator getInstance()
Return a singleton instance of this validator.- Returns:
- A singleton instance of the PercentValidator.
-
parse
protected java.lang.Object parse(java.lang.String value, java.text.Format formatter)
Parse the value with the specified
Format
.This implementation is lenient whether the currency symbol is present or not. The default
NumberFormat
behaviour is for the parsing to "fail" if the currency symbol is missing. This method re-parses with a format without the currency symbol if it fails initially.- Overrides:
parse
in classAbstractFormatValidator
- Parameters:
value
- The value to be parsed.formatter
- The Format to parse the value with.- Returns:
- The parsed value if valid or
null
if invalid.
-
-