org.codehaus.groovy.grails.validation

Class ConstrainedProperty

java.lang.Object

org.codehaus.groovy.grails.validation.ConstrainedProperty

public class ConstrainedProperty
extends java.lang.Object

Provides the ability to set contraints against a properties of a class. Constraints can either be set via the property setters or via the

applyConstraint(String constraintName, Object constrainingValue)

in combination with a constraint constant. Example: ... ConstrainedProperty cp = new ConstrainedProperty(owningClass, propertyName, propertyType); if (cp.supportsConstraint(ConstrainedProperty.EMAIL_CONSTRAINT)) { cp.applyConstraint(ConstrainedProperty.EMAIL_CONSTRAINT, new Boolean(true)); } Alternatively constraints can be applied directly using the java bean getters/setters if a static (as oposed to dynamic) approach to constraint creation is possible: cp.setEmail(true)

Since:

07-Nov-2005

Author:

Graeme Rocher

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	BLANK_CONSTRAINT
static java.lang.String	CREDIT_CARD_CONSTRAINT
static java.lang.String	EMAIL_CONSTRAINT
static java.lang.String	IN_LIST_CONSTRAINT
static java.lang.String	MATCHES_CONSTRAINT
static java.lang.String	MAX_CONSTRAINT
static java.lang.String	MAX_SIZE_CONSTRAINT
static java.lang.String	MIN_CONSTRAINT
static java.lang.String	MIN_SIZE_CONSTRAINT
static java.lang.String	NOT_EQUAL_CONSTRAINT
static java.lang.String	NULLABLE_CONSTRAINT
static java.lang.String	RANGE_CONSTRAINT
static java.lang.String	SCALE_CONSTRAINT
static java.lang.String	SIZE_CONSTRAINT
static java.lang.String	URL_CONSTRAINT
static java.lang.String	VALIDATOR_CONSTRAINT

Constructor Summary

Constructors

Constructor and Description
ConstrainedProperty(java.lang.Class<?> clazz, java.lang.String propertyName, java.lang.Class<?> propertyType) Constructs a new ConstrainedProperty for the given arguments.

Method Summary

Modifier and Type	Method and Description
void	addMetaConstraint(java.lang.String name, java.lang.Object value) Adds a meta constraints which is a non-validating informational constraint.
void	applyConstraint(java.lang.String constraintName, java.lang.Object constrainingValue) Applies a constraint for the specified name and consraint value.
Constraint	getAppliedConstraint(java.lang.String name) Obtains an applied constraint by name.
java.util.Collection<Constraint>	getAppliedConstraints()
java.util.Map	getAttributes()
java.lang.String	getFormat()
java.util.List	getInList()
java.lang.String	getMatches()
java.lang.Comparable	getMax()
java.lang.Integer	getMaxSize()
java.lang.Object	getMetaConstraintValue(java.lang.String name) Obtains the value of the named meta constraint.
java.lang.Comparable	getMin()
java.lang.Integer	getMinSize()
java.lang.Object	getNotEqual()
int	getOrder()
java.lang.String	getPropertyName()
java.lang.Class<?>	getPropertyType()
Range	getRange()
java.lang.Integer	getScale()
Range	getSize()
java.lang.String	getWidget()
boolean	hasAppliedConstraint(java.lang.String constraintName)
static boolean	hasRegisteredConstraint(java.lang.String constraintName)
boolean	isBlank()
boolean	isCreditCard()
boolean	isDisplay()
boolean	isEditable()
boolean	isEmail()
boolean	isNullable()
boolean	isPassword()
boolean	isUrl()
static void	registerNewConstraint(java.lang.String name, java.lang.Class<?> constraintClass)
static void	registerNewConstraint(java.lang.String name, ConstraintFactory factory)
static void	removeConstraint(java.lang.String name)
static void	removeConstraint(java.lang.String name, java.lang.Class constraintClass)
void	setAttributes(java.util.Map attributes)
void	setBlank(boolean blank)
void	setCreditCard(boolean creditCard)
void	setDisplay(boolean display)
void	setEditable(boolean editable)
void	setEmail(boolean email)
void	setFormat(java.lang.String format)
void	setInList(java.util.List inList)
void	setMatches(java.lang.String regex)
void	setMax(java.lang.Comparable max)
void	setMaxSize(java.lang.Integer maxSize)
void	setMessageSource(MessageSource source) The message source used to evaluate error messages
void	setMin(java.lang.Comparable min)
void	setMinSize(java.lang.Integer minSize)
void	setNotEqual(java.lang.Object notEqual)
void	setNullable(boolean nullable)
void	setOrder(int order)
void	setPassword(boolean password)
void	setPropertyName(java.lang.String propertyName)
void	setRange(Range range)
void	setSize(Range size)
void	setUrl(boolean url)
void	setWidget(java.lang.String widget)
boolean	supportsContraint(java.lang.String constraintName) Checks with this ConstraintedProperty instance supports applying the specified constraint.
java.lang.String	toString()
void	validate(java.lang.Object target, java.lang.Object propertyValue, Errors errors) Validate this constrainted property against specified property value

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

CREDIT_CARD_CONSTRAINT

public static final java.lang.String CREDIT_CARD_CONSTRAINT

See Also:

Constant Field Values

EMAIL_CONSTRAINT

public static final java.lang.String EMAIL_CONSTRAINT

See Also:

Constant Field Values

BLANK_CONSTRAINT

public static final java.lang.String BLANK_CONSTRAINT

See Also:

Constant Field Values

RANGE_CONSTRAINT

public static final java.lang.String RANGE_CONSTRAINT

See Also:

Constant Field Values

IN_LIST_CONSTRAINT

public static final java.lang.String IN_LIST_CONSTRAINT

See Also:

Constant Field Values

URL_CONSTRAINT

public static final java.lang.String URL_CONSTRAINT

See Also:

Constant Field Values

MATCHES_CONSTRAINT

public static final java.lang.String MATCHES_CONSTRAINT

See Also:

Constant Field Values

SIZE_CONSTRAINT

public static final java.lang.String SIZE_CONSTRAINT

See Also:

Constant Field Values

MIN_CONSTRAINT

public static final java.lang.String MIN_CONSTRAINT

See Also:

Constant Field Values

MAX_CONSTRAINT

public static final java.lang.String MAX_CONSTRAINT

See Also:

Constant Field Values

MAX_SIZE_CONSTRAINT

public static final java.lang.String MAX_SIZE_CONSTRAINT

See Also:

Constant Field Values

MIN_SIZE_CONSTRAINT

public static final java.lang.String MIN_SIZE_CONSTRAINT

See Also:

Constant Field Values

SCALE_CONSTRAINT

public static final java.lang.String SCALE_CONSTRAINT

See Also:

Constant Field Values

NOT_EQUAL_CONSTRAINT

public static final java.lang.String NOT_EQUAL_CONSTRAINT

See Also:

Constant Field Values

NULLABLE_CONSTRAINT

public static final java.lang.String NULLABLE_CONSTRAINT

See Also:

Constant Field Values

VALIDATOR_CONSTRAINT

public static final java.lang.String VALIDATOR_CONSTRAINT

See Also:

Constant Field Values

Constructor Detail

ConstrainedProperty

public ConstrainedProperty(java.lang.Class<?> clazz,
                           java.lang.String propertyName,
                           java.lang.Class<?> propertyType)

Constructs a new ConstrainedProperty for the given arguments.

Parameters:

clazz - The owning class

propertyName - The name of the property

propertyType - The property type

Method Detail

removeConstraint

public static void removeConstraint(java.lang.String name,
                                    java.lang.Class constraintClass)

removeConstraint

public static void removeConstraint(java.lang.String name)

registerNewConstraint

public static void registerNewConstraint(java.lang.String name,
                                         java.lang.Class<?> constraintClass)

registerNewConstraint

public static void registerNewConstraint(java.lang.String name,
                                         ConstraintFactory factory)

hasRegisteredConstraint

public static boolean hasRegisteredConstraint(java.lang.String constraintName)

getAppliedConstraints

public java.util.Collection<Constraint> getAppliedConstraints()

Returns:

Returns the appliedConstraints.

getAppliedConstraint

public Constraint getAppliedConstraint(java.lang.String name)

Obtains an applied constraint by name.

Parameters:

name - The name of the constraint

Returns:

The applied constraint

hasAppliedConstraint

public boolean hasAppliedConstraint(java.lang.String constraintName)

Parameters:

constraintName - The name of the constraint to check

Returns:

Returns true if the specified constraint name is being applied to this property

getPropertyType

public java.lang.Class<?> getPropertyType()

Returns:

Returns the propertyType.

getMax

public java.lang.Comparable getMax()

Returns:

Returns the max.

setMax

public void setMax(java.lang.Comparable max)

Parameters:

max - The max to set.

getMin

public java.lang.Comparable getMin()

Returns:

Returns the min.

setMin

public void setMin(java.lang.Comparable min)

Parameters:

min - The min to set.

getInList

public java.util.List getInList()

Returns:

Returns the inList.

setInList

public void setInList(java.util.List inList)

Parameters:

inList - The inList to set.

getRange

public Range getRange()

Returns:

Returns the range.

setRange

public void setRange(Range range)

Parameters:

range - The range to set.

getScale

public java.lang.Integer getScale()

Returns:

The scale, if defined for this property; null, otherwise

getSize

public Range getSize()

Returns:

Returns the size.

setSize

public void setSize(Range size)

Parameters:

size - The size to set.

isBlank

public boolean isBlank()

Returns:

Returns the blank.

setBlank

public void setBlank(boolean blank)

Parameters:

blank - The blank to set.

isEmail

public boolean isEmail()

Returns:

Returns the email.

setEmail

public void setEmail(boolean email)

Parameters:

email - The email to set.

isCreditCard

public boolean isCreditCard()

Returns:

Returns the creditCard.

setCreditCard

public void setCreditCard(boolean creditCard)

Parameters:

creditCard - The creditCard to set.

getMatches

public java.lang.String getMatches()

Returns:

Returns the matches.

setMatches

public void setMatches(java.lang.String regex)

Parameters:

regex - The matches to set.

getNotEqual

public java.lang.Object getNotEqual()

Returns:

Returns the notEqual.

getMaxSize

public java.lang.Integer getMaxSize()

Returns:

Returns the maxSize.

setMaxSize

public void setMaxSize(java.lang.Integer maxSize)

Parameters:

maxSize - The maxSize to set.

getMinSize

public java.lang.Integer getMinSize()

Returns:

Returns the minSize.

setMinSize

public void setMinSize(java.lang.Integer minSize)

Parameters:

minSize - The minLength to set.

setNotEqual

public void setNotEqual(java.lang.Object notEqual)

Parameters:

notEqual - The notEqual to set.

isNullable

public boolean isNullable()

Returns:

Returns the nullable.

setNullable

public void setNullable(boolean nullable)

Parameters:

nullable - The nullable to set.

getPropertyName

public java.lang.String getPropertyName()

Returns:

Returns the propertyName.

setPropertyName

public void setPropertyName(java.lang.String propertyName)

Parameters:

propertyName - The propertyName to set.

isUrl

public boolean isUrl()

Returns:

Returns the url.

setUrl

public void setUrl(boolean url)

Parameters:

url - The url to set.

isDisplay

public boolean isDisplay()

Returns:

Returns the display.

setDisplay

public void setDisplay(boolean display)

Parameters:

display - The display to set.

isEditable

public boolean isEditable()

Returns:

Returns the editable.

setEditable

public void setEditable(boolean editable)

Parameters:

editable - The editable to set.

getOrder

public int getOrder()

Returns:

Returns the order.

setOrder

public void setOrder(int order)

Parameters:

order - The order to set.

getFormat

public java.lang.String getFormat()

setFormat

public void setFormat(java.lang.String format)

isPassword

public boolean isPassword()

setPassword

public void setPassword(boolean password)

getAttributes

public java.util.Map getAttributes()

setAttributes

public void setAttributes(java.util.Map attributes)

getWidget

public java.lang.String getWidget()

setWidget

public void setWidget(java.lang.String widget)

setMessageSource

public void setMessageSource(MessageSource source)

The message source used to evaluate error messages

Parameters:

source - The MessageSource instance to use to resolve messages

validate

public void validate(java.lang.Object target,
                     java.lang.Object propertyValue,
                     Errors errors)

Validate this constrainted property against specified property value

Parameters:

target - The target object to validate

propertyValue - The value of the property to validate

errors - The Errors instances to report errors to

supportsContraint

public boolean supportsContraint(java.lang.String constraintName)

Checks with this ConstraintedProperty instance supports applying the specified constraint.

Parameters:

constraintName - The name of the constraint

Returns:

True if the constraint is supported

applyConstraint

public void applyConstraint(java.lang.String constraintName,
                            java.lang.Object constrainingValue)

Applies a constraint for the specified name and consraint value.

Parameters:

constraintName - The name of the constraint

constrainingValue - The constraining value

Throws:

ConstraintException - Thrown when the specified constraint is not supported by this ConstrainedProperty. Use supportsContraint(String constraintName) to check before calling

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

addMetaConstraint

public void addMetaConstraint(java.lang.String name,
                              java.lang.Object value)

Adds a meta constraints which is a non-validating informational constraint.

Parameters:

name - The name of the constraint

value - The value

getMetaConstraintValue

public java.lang.Object getMetaConstraintValue(java.lang.String name)

Obtains the value of the named meta constraint.

Parameters:

name - The name of the constraint

Returns:

The value