org.apache.commons.validator.routines
public abstract class AbstractFormatValidator extends Object implements Serializable
Abstract class for Format based Validation.
This is a base class for building Date and Number Validators using format parsing.
Since: Validator 1.3.0
Version: $Revision: 478334 $ $Date: 2006-11-22 21:31:54 +0000 (Wed, 22 Nov 2006) $
Field Summary | |
---|---|
boolean | strict |
Constructor Summary | |
---|---|
AbstractFormatValidator(boolean strict)
Construct an instance with the specified strict setting.
|
Method Summary | |
---|---|
String | format(Object value) Format an object into a |
String | format(Object value, String pattern) Format an object into a |
String | format(Object value, Locale locale) Format an object into a |
String | format(Object value, String pattern, Locale locale) Format an object using the specified pattern and/or
|
protected String | format(Object value, Format formatter) Format a value with the specified |
protected abstract Format | getFormat(String pattern, Locale locale) Returns a |
boolean | isStrict() Indicates whether validated values should adhere
strictly to the Typically implementations of |
boolean | isValid(String value) Validate using the default |
boolean | isValid(String value, String pattern) Validate using the specified pattern. |
boolean | isValid(String value, Locale locale) Validate using the specified |
abstract boolean | isValid(String value, String pattern, Locale locale) Validate using the specified pattern and/or |
protected Object | parse(String value, Format formatter) Parse the value with the specified |
protected abstract Object | processParsedValue(Object value, Format formatter) Process the parsed value, performing any further validation and type conversion required. |
Parameters: strict true
if strict
Format
parsing should be used.
Format an object into a String
using
the default Locale.
Parameters: value The value validation is being performed on.
Returns: The value formatted as a String
.
Format an object into a String
using
the specified pattern.
Parameters: value The value validation is being performed on. pattern The pattern used to format the value.
Returns: The value formatted as a String
.
Format an object into a String
using
the specified Locale.
Parameters: value The value validation is being performed on. locale The locale to use for the Format.
Returns: The value formatted as a String
.
Format an object using the specified pattern and/or
Locale
.
Parameters: value The value validation is being performed on. pattern The pattern used to format the value. locale The locale to use for the Format.
Returns: The value formatted as a String
.
Format a value with the specified Format
.
Parameters: value The value to be formatted. formatter The Format to use.
Returns: The formatted value.
Returns a Format
for the specified pattern
and/or Locale
.
Parameters: pattern The pattern used to validate the value against or
null
to use the default for the Locale
. locale The locale to use for the currency format, system default if null.
Returns: The NumberFormat
to created.
Indicates whether validated values should adhere
strictly to the Format
used.
Typically implementations of Format
ignore invalid characters at the end of the value
and just stop parsing. For example parsing a date
value of 01/01/20x0
using a pattern
of dd/MM/yyyy
will result in a year
of 20
if strict
is set
to false
, whereas setting strict
to true
will cause this value to fail
validation.
Returns: true
if strict Format
parsing should be used.
Validate using the default Locale
.
Parameters: value The value validation is being performed on.
Returns: true
if the value is valid.
Validate using the specified pattern.
Parameters: value The value validation is being performed on. pattern The pattern used to validate the value against.
Returns: true
if the value is valid.
Validate using the specified Locale
.
Parameters: value The value validation is being performed on. locale The locale to use for the Format, defaults to the default
Returns: true
if the value is valid.
Validate using the specified pattern and/or Locale
.
Parameters: value The value validation is being performed on. pattern The pattern used to format the value. locale The locale to use for the Format, defaults to the default
Returns: true
if the value is valid.
Parse the value with the specified Format
.
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.
Process the parsed value, performing any further validation and type conversion required.
Parameters: value The parsed object created. formatter The Format used to parse the value with.
Returns: The parsed value converted to the appropriate type
if valid or null
if invalid.