Class 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: 478334 $ $Date: 2006-11-22 21:31:54 +0000 (Wed, 22 Nov 2006) $
    See Also:
    Serialized Form
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      private static int adjustForLineEnding​(java.lang.String value, int lineEndLength)
      Calculate an adjustment amount for line endings.
      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
    • Field Detail

      • URL_VALIDATOR

        private static final UrlValidator URL_VALIDATOR
        UrlValidator used in wrapper method.
      • CREDIT_CARD_VALIDATOR

        private static final CreditCardValidator CREDIT_CARD_VALIDATOR
        CreditCardValidator used in wrapper method.
    • 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.
      • adjustForLineEnding

        private static int adjustForLineEnding​(java.lang.String value,
                                               int lineEndLength)
        Calculate an adjustment amount for line endings. See Bug 37962 for the rational behind this.
        Parameters:
        value - The value validation is being performed on.
        lineEndLength - The length to use for line endings.
        Returns:
        the adjustment amount.
      • 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.