com.gammastream.validity
Class GSVStringMethods

java.lang.Object
  com.gammastream.validity.GSVStringMethods

public class GSVStringMethods
extends Object

This class provides a set of predefined rules for performing validation on Strings. These rules are part of the default set of 'QuickRules'.

Author:

GammaStream Technologies, Inc.

Field Summary

static String	EQUAL For programatic purposes, we include this constant which is used for the compareTo method.
static String	GREATER_EQUAL For programatic purposes, we include this constant which is used for the compareTo method.
static String	GREATER_THAN For programatic purposes, we include this constant which is used for the compareTo method.
static String	LESS_EQUAL For programatic purposes, we include this constant which is used for the compareTo method.
static String	LESS_THAN For programatic purposes, we include this constant which is used for the compareTo method.
static String	NOT_EQUAL For programatic purposes, we include this constant which is used for the compareTo method.

Constructor Summary

GSVStringMethods()

Method Summary

static boolean	compareTo(Object object, Object attribute, String key, NSDictionary params) Performs a string comparision using the specified params dictionary.
static boolean	contains(Object object, Object attribute, String key, NSDictionary params) Verifies that the attribute contains the specified string.
static boolean	endsWith(Object object, Object attribute, String key, NSDictionary params) Verifies that the attribute ends with the specified string.
static boolean	isAlphabetic(Object object, Object attribute, String key, NSDictionary params) Verifies that the attribute contains only alphabetic characters.
static boolean	isAlphaNumeric(Object object, Object attribute, String key, NSDictionary params) Verifies that the attribute contains only letters or numbers.
static boolean	isStringEmpty(Object object, Object attribute, String key, NSDictionary params) Determines whether the specified attribute is empty.
static boolean	isValidEmailAddress(Object object, Object attribute, String key, NSDictionary params) Verifies the attribute is a valid email address.
static boolean	isValidURL(Object object, Object attribute, String key, NSDictionary params) Verifies the attribute is a valid url.
static boolean	length(Object object, Object attribute, String key, NSDictionary params) Determines whether the specified string is of a specified length.
static boolean	maxLength(Object object, Object attribute, String key, NSDictionary params) Determines whether the specified string is of a specified length.
static boolean	minLength(Object object, Object attribute, String key, NSDictionary params) Determines whether the specified string is of a specified length.
static boolean	startsWith(Object object, Object attribute, String key, NSDictionary params) Verifies that the attribute starts with the specified string.
static boolean	stripHTML(Object object, Object attribute, String key, NSDictionary params) One of the many 'mutators' which never fail, unless of course, an exception is thrown.
static boolean	toLowerCase(Object object, Object attribute, String key, NSDictionary params) One of the many 'mutators' which never fail, unless of course, an exception is thrown.
static boolean	toUpperCase(Object object, Object attribute, String key, NSDictionary params) One of the many 'mutators' which never fail, unless of course, an exception is thrown.

Methods inherited from class java.lang.Object

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

Field Detail

EQUAL

public static final String EQUAL

For programatic purposes, we include this constant which is used for the compareTo method.

See Also:

Constant Field Values

NOT_EQUAL

public static final String NOT_EQUAL

For programatic purposes, we include this constant which is used for the compareTo method.

See Also:

Constant Field Values

GREATER_THAN

public static final String GREATER_THAN

For programatic purposes, we include this constant which is used for the compareTo method.

See Also:

Constant Field Values

GREATER_EQUAL

public static final String GREATER_EQUAL

For programatic purposes, we include this constant which is used for the compareTo method.

See Also:

Constant Field Values

LESS_THAN

public static final String LESS_THAN

For programatic purposes, we include this constant which is used for the compareTo method.

See Also:

Constant Field Values

LESS_EQUAL

public static final String LESS_EQUAL

For programatic purposes, we include this constant which is used for the compareTo method.

See Also:

Constant Field Values

Constructor Detail

GSVStringMethods

public GSVStringMethods()

Method Detail

isStringEmpty

public static final boolean isStringEmpty(Object object,
                                          Object attribute,
                                          String key,
                                          NSDictionary params)

Determines whether the specified attribute is empty.
An empty String is defined as a String that contains at least one non-white-space character.
(i.e. This method will return true if the attribute only contains spaces, CRs, NLs, etc.)

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

true if the string is empty; otherwise, false

toUpperCase

public static final boolean toUpperCase(Object object,
                                        Object attribute,
                                        String key,
                                        NSDictionary params)

One of the many 'mutators' which never fail, unless of course, an exception is thrown.
A mutator simply modifies (or mutates) the attribute in some way.
In this case, it converts the String to all upper case characters.

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

always true

toLowerCase

public static final boolean toLowerCase(Object object,
                                        Object attribute,
                                        String key,
                                        NSDictionary params)

One of the many 'mutators' which never fail, unless of course, an exception is thrown.
A mutator simply modifies (or mutates) the attribute is some way.
In this case, it converts the String to all lower case characters.

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

always true

length

public static final boolean length(Object object,
                                   Object attribute,
                                   String key,
                                   NSDictionary params)

Determines whether the specified string is of a specified length. (i.e. 'x' characters long)

The required key-value pairs include:
"Operator" = One of the defined operator constants.
"RightOperand" = A number representing the number of characters one is interested.

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

true if the comparison succeeds; otherwise, false

minLength

public static final boolean minLength(Object object,
                                      Object attribute,
                                      String key,
                                      NSDictionary params)

Determines whether the specified string is of a specified length. (i.e. 'x' characters long)

The required key-value pairs include:
"minLength" = A number representing the number of characters one is interested.

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

true if the comparison succeeds; otherwise, false

maxLength

public static final boolean maxLength(Object object,
                                      Object attribute,
                                      String key,
                                      NSDictionary params)

Determines whether the specified string is of a specified length. (i.e. 'x' characters long)

The required key-value pairs include:
"maxLength" = A number representing the number of characters one is interested.

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

true if the comparison succeeds; otherwise, false

contains

public static final boolean contains(Object object,
                                     Object attribute,
                                     String key,
                                     NSDictionary params)

Verifies that the attribute contains the specified string.

The required key-value pairs include:
"Contains" = The string of interest.

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

true if the attribute contains the specified string; otherwise, false

endsWith

public static final boolean endsWith(Object object,
                                     Object attribute,
                                     String key,
                                     NSDictionary params)

Verifies that the attribute ends with the specified string.

The required key-value pairs include:
"EndsWith" = The string of interest.

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

true if the attribute ends with the specified string; otherwise, false

startsWith

public static final boolean startsWith(Object object,
                                       Object attribute,
                                       String key,
                                       NSDictionary params)

Verifies that the attribute starts with the specified string.

The required key-value pairs include:
"StartsWith" = The string of interest.

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

true if the attribute starts with the specified string; otherwise, false

isAlphabetic

public static final boolean isAlphabetic(Object object,
                                         Object attribute,
                                         String key,
                                         NSDictionary params)

Verifies that the attribute contains only alphabetic characters. (i.e. 'a'-'z' || 'A'-'Z')

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

true if the string only contains alphabetic characters; otherwise, false

isAlphaNumeric

public static final boolean isAlphaNumeric(Object object,
                                           Object attribute,
                                           String key,
                                           NSDictionary params)

Verifies that the attribute contains only letters or numbers. (i.e. 'a'-'z' || 'A'-'Z' || '0'-'9')

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

true if the string only contains letters or numbers; otherwise, false

stripHTML

public static final boolean stripHTML(Object object,
                                      Object attribute,
                                      String key,
                                      NSDictionary params)

One of the many 'mutators' which never fail, unless of course, an exception is thrown.
A mutator simply modifies (or mutates) the attribute is some way.
In this case, it strips any HTML out of the String.
HTML is considered anything (and including) '<' and '>'.

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

always true

compareTo

public static final boolean compareTo(Object object,
                                      Object attribute,
                                      String key,
                                      NSDictionary params)

Performs a string comparision using the specified params dictionary.

The required key-value pairs include:
"Operator" = The specified operator string. (i.e. "==", "!=", ">", ">=", "<", or "<=" )
"RightOperand" = The String to compare the attribute to.

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

true if the comparision succeeds; otherwise, false

isValidURL

public static final boolean isValidURL(Object object,
                                       Object attribute,
                                       String key,
                                       NSDictionary params)

Verifies the attribute is a valid url. (Proper Syntax)
The validator will only verify 'http' urls.

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

true if the url is valid; otherwise, false

isValidEmailAddress

public static final boolean isValidEmailAddress(Object object,
                                                Object attribute,
                                                String key,
                                                NSDictionary params)

Verifies the attribute is a valid email address. (Proper Syntax)

Parameters:

object - The object whose attribute is being validated.

attribute - The attribute being validated.

key - The key used to access the attribute.

params - The param dictionary which must contain the above mentioned key-value pairs.

Returns:

true if the address is valid; otherwise, false