Package org.apache.commons.validator

Class GenericValidator

java.lang.Object

org.apache.commons.validator.GenericValidator

All Implemented Interfaces:

java.io.Serializable

public class GenericValidator
extends java.lang.Object
implements java.io.Serializable

This class contains basic methods for performing validations.

Version:

$Revision: 1649191 $

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
GenericValidator()

Method Summary

Modifier and Type	Method	Description
static boolean	isBlankOrNull(java.lang.String value)	Checks if the field isn't null and length of the field is greater than zero not including whitespace.
static boolean	isByte(java.lang.String value)	Checks if the value can safely be converted to a byte primitive.
static boolean	isCreditCard(java.lang.String value)	Checks if the field is a valid credit card number.
static boolean	isDate(java.lang.String value, java.lang.String datePattern, boolean strict)	Checks if the field is a valid date.
static boolean	isDate(java.lang.String value, java.util.Locale locale)	Checks if the field is a valid date.
static boolean	isDouble(java.lang.String value)	Checks if the value can safely be converted to a double primitive.
static boolean	isEmail(java.lang.String value)	Checks if a field has a valid e-mail address.
static boolean	isFloat(java.lang.String value)	Checks if the value can safely be converted to a float primitive.
static boolean	isInRange(byte value, byte min, byte max)	Checks if a value is within a range (min & max specified in the vars attribute).
static boolean	isInRange(double value, double min, double max)	Checks if a value is within a range (min & max specified in the vars attribute).
static boolean	isInRange(float value, float min, float max)	Checks if a value is within a range (min & max specified in the vars attribute).
static boolean	isInRange(int value, int min, int max)	Checks if a value is within a range (min & max specified in the vars attribute).
static boolean	isInRange(long value, long min, long max)	Checks if a value is within a range (min & max specified in the vars attribute).
static boolean	isInRange(short value, short min, short max)	Checks if a value is within a range (min & max specified in the vars attribute).
static boolean	isInt(java.lang.String value)	Checks if the value can safely be converted to a int primitive.
static boolean	isLong(java.lang.String value)	Checks if the value can safely be converted to a long primitive.
static boolean	isShort(java.lang.String value)	Checks if the value can safely be converted to a short primitive.
static boolean	isUrl(java.lang.String value)	Checks if a field is a valid url address.
static boolean	matchRegexp(java.lang.String value, java.lang.String regexp)	Checks if the value matches the regular expression.
static boolean	maxLength(java.lang.String value, int max)	Checks if the value's length is less than or equal to the max.
static boolean	maxLength(java.lang.String value, int max, int lineEndLength)	Checks if the value's adjusted length is less than or equal to the max.
static boolean	maxValue(double value, double max)	Checks if the value is less than or equal to the max.
static boolean	maxValue(float value, float max)	Checks if the value is less than or equal to the max.
static boolean	maxValue(int value, int max)	Checks if the value is less than or equal to the max.
static boolean	maxValue(long value, long max)	Checks if the value is less than or equal to the max.
static boolean	minLength(java.lang.String value, int min)	Checks if the value's length is greater than or equal to the min.
static boolean	minLength(java.lang.String value, int min, int lineEndLength)	Checks if the value's adjusted length is greater than or equal to the min.
static boolean	minValue(double value, double min)	Checks if the value is greater than or equal to the min.
static boolean	minValue(float value, float min)	Checks if the value is greater than or equal to the min.
static boolean	minValue(int value, int min)	Checks if the value is greater than or equal to the min.
static boolean	minValue(long value, long min)	Checks if the value is greater than or equal to the min.

Methods inherited from class java.lang.Object

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

Constructor Detail

GenericValidator

public GenericValidator()

Method Detail

isBlankOrNull

public static boolean isBlankOrNull(java.lang.String value)

Checks if the field isn't null and length of the field is greater than zero not including whitespace.

Parameters:

value - The value validation is being performed on.

Returns:

true if blank or null.

matchRegexp

public static boolean matchRegexp(java.lang.String value,
                                  java.lang.String regexp)

Checks if the value matches the regular expression.

Parameters:

value - The value validation is being performed on.

regexp - The regular expression.

Returns:

true if matches the regular expression.

isByte

public static boolean isByte(java.lang.String value)

Checks if the value can safely be converted to a byte primitive.

Parameters:

value - The value validation is being performed on.

Returns:

true if the value can be converted to a Byte.

isShort

public static boolean isShort(java.lang.String value)

Checks if the value can safely be converted to a short primitive.

Parameters:

value - The value validation is being performed on.

Returns:

true if the value can be converted to a Short.

isInt

public static boolean isInt(java.lang.String value)

Checks if the value can safely be converted to a int primitive.

Parameters:

value - The value validation is being performed on.

Returns:

true if the value can be converted to an Integer.

isLong

public static boolean isLong(java.lang.String value)

Checks if the value can safely be converted to a long primitive.

Parameters:

value - The value validation is being performed on.

Returns:

true if the value can be converted to a Long.

isFloat

public static boolean isFloat(java.lang.String value)

Checks if the value can safely be converted to a float primitive.

Parameters:

value - The value validation is being performed on.

Returns:

true if the value can be converted to a Float.

isDouble

public static boolean isDouble(java.lang.String value)

Checks if the value can safely be converted to a double primitive.

Parameters:

value - The value validation is being performed on.

Returns:

true if the value can be converted to a Double.

isDate

public static boolean isDate(java.lang.String value,
                             java.util.Locale locale)

Checks if the field is a valid date. The Locale is used with java.text.DateFormat. The setLenient method is set to false for all.

Parameters:

value - The value validation is being performed on.

locale - The locale to use for the date format, defaults to the system default if null.

Returns:

true if the value can be converted to a Date.

isDate

public static boolean isDate(java.lang.String value,
                             java.lang.String datePattern,
                             boolean strict)

Checks if the field is a valid date. The pattern is used with java.text.SimpleDateFormat. If strict is true, then the length will be checked so '2/12/1999' will not pass validation with the format 'MM/dd/yyyy' because the month isn't two digits. The setLenient method is set to false for all.

Parameters:

value - The value validation is being performed on.

datePattern - The pattern passed to SimpleDateFormat.

strict - Whether or not to have an exact match of the datePattern.

Returns:

true if the value can be converted to a Date.

isInRange

public static boolean isInRange(byte value,
                                byte min,
                                byte max)

Checks if a value is within a range (min & max specified in the vars attribute).

Parameters:

value - The value validation is being performed on.

min - The minimum value of the range.

max - The maximum value of the range.

Returns:

true if the value is in the specified range.

isInRange

public static boolean isInRange(int value,
                                int min,
                                int max)

Checks if a value is within a range (min & max specified in the vars attribute).

Parameters:

value - The value validation is being performed on.

min - The minimum value of the range.

max - The maximum value of the range.

Returns:

true if the value is in the specified range.

isInRange

public static boolean isInRange(float value,
                                float min,
                                float max)

Checks if a value is within a range (min & max specified in the vars attribute).

Parameters:

value - The value validation is being performed on.

min - The minimum value of the range.

max - The maximum value of the range.

Returns:

true if the value is in the specified range.

isInRange

public static boolean isInRange(short value,
                                short min,
                                short max)

Checks if a value is within a range (min & max specified in the vars attribute).

Parameters:

value - The value validation is being performed on.

min - The minimum value of the range.

max - The maximum value of the range.

Returns:

true if the value is in the specified range.

isInRange

public static boolean isInRange(long value,
                                long min,
                                long max)

Checks if a value is within a range (min & max specified in the vars attribute).

Parameters:

value - The value validation is being performed on.

min - The minimum value of the range.

max - The maximum value of the range.

Returns:

true if the value is in the specified range.

isInRange

public static boolean isInRange(double value,
                                double min,
                                double max)

Checks if a value is within a range (min & max specified in the vars attribute).

Parameters:

value - The value validation is being performed on.

min - The minimum value of the range.

max - The maximum value of the range.

Returns:

true if the value is in the specified range.

isCreditCard

public static boolean isCreditCard(java.lang.String value)

Checks if the field is a valid credit card number.

Parameters:

value - The value validation is being performed on.

Returns:

true if the value is valid Credit Card Number.

isEmail

public static boolean isEmail(java.lang.String value)

Checks if a field has a valid e-mail address.

Parameters:

value - The value validation is being performed on.

Returns:

true if the value is valid Email Address.

isUrl

public static boolean isUrl(java.lang.String value)

Checks if a field is a valid url address.

If you need to modify what is considered valid then consider using the UrlValidator directly.

Parameters:

value - The value validation is being performed on.

Returns:

true if the value is valid Url.

maxLength

public static boolean maxLength(java.lang.String value,
                                int max)

Checks if the value's length is less than or equal to the max.

Parameters:

value - The value validation is being performed on.

max - The maximum length.

Returns:

true if the value's length is less than the specified maximum.

maxLength

public static boolean maxLength(java.lang.String value,
                                int max,
                                int lineEndLength)

Checks if the value's adjusted length is less than or equal to the max.

Parameters:

value - The value validation is being performed on.

max - The maximum length.

lineEndLength - The length to use for line endings.

Returns:

true if the value's length is less than the specified maximum.

minLength

public static boolean minLength(java.lang.String value,
                                int min)

Checks if the value's length is greater than or equal to the min.

Parameters:

value - The value validation is being performed on.

min - The minimum length.

Returns:

true if the value's length is more than the specified minimum.

minLength

public static boolean minLength(java.lang.String value,
                                int min,
                                int lineEndLength)

Checks if the value's adjusted length is greater than or equal to the min.

Parameters:

value - The value validation is being performed on.

min - The minimum length.

lineEndLength - The length to use for line endings.

Returns:

true if the value's length is more than the specified minimum.

minValue

public static boolean minValue(int value,
                               int min)

Checks if the value is greater than or equal to the min.

Parameters:

value - The value validation is being performed on.

min - The minimum numeric value.

Returns:

true if the value is >= the specified minimum.

minValue

public static boolean minValue(long value,
                               long min)

Checks if the value is greater than or equal to the min.

Parameters:

value - The value validation is being performed on.

min - The minimum numeric value.

Returns:

true if the value is >= the specified minimum.

minValue

public static boolean minValue(double value,
                               double min)

Checks if the value is greater than or equal to the min.

Parameters:

value - The value validation is being performed on.

min - The minimum numeric value.

Returns:

true if the value is >= the specified minimum.

minValue

public static boolean minValue(float value,
                               float min)

Checks if the value is greater than or equal to the min.

Parameters:

value - The value validation is being performed on.

min - The minimum numeric value.

Returns:

true if the value is >= the specified minimum.

maxValue

public static boolean maxValue(int value,
                               int max)

Checks if the value is less than or equal to the max.

Parameters:

value - The value validation is being performed on.

max - The maximum numeric value.

Returns:

true if the value is <= the specified maximum.

maxValue

public static boolean maxValue(long value,
                               long max)

Checks if the value is less than or equal to the max.

Parameters:

value - The value validation is being performed on.

max - The maximum numeric value.

Returns:

true if the value is <= the specified maximum.

maxValue

public static boolean maxValue(double value,
                               double max)

Checks if the value is less than or equal to the max.

Parameters:

value - The value validation is being performed on.

max - The maximum numeric value.

Returns:

true if the value is <= the specified maximum.

maxValue

public static boolean maxValue(float value,
                               float max)

Checks if the value is less than or equal to the max.

Parameters:

value - The value validation is being performed on.

max - The maximum numeric value.

Returns:

true if the value is <= the specified maximum.