org.codehaus.groovy.grails.validation

Class ConstrainedProperty

java.lang.Object

org.codehaus.groovy.grails.validation.ConstrainedProperty

All Implemented Interfaces:

grails.validation.Constrained

public class ConstrainedProperty
extends java.lang.Object
implements grails.validation.Constrained

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

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Map<java.lang.String,Constraint>	appliedConstraints
static java.lang.String	BLANK_CONSTRAINT
protected static java.util.ResourceBundle	bundle
protected static java.util.Map<java.lang.String,java.util.List<java.lang.Object>>	constraints
static java.lang.String	CREDIT_CARD_CONSTRAINT
protected static java.util.Map<java.lang.String,java.lang.String>	DEFAULT_MESSAGES
static java.lang.String	EMAIL_CONSTRAINT
protected static java.lang.String	EXCEEDED_SUFFIX
static java.lang.String	IN_LIST_CONSTRAINT
protected static java.lang.String	INVALID_SUFFIX
protected static org.apache.commons.logging.Log	LOG
static java.lang.String	MATCHES_CONSTRAINT
static java.lang.String	MAX_CONSTRAINT
static java.lang.String	MAX_SIZE_CONSTRAINT
protected org.springframework.context.MessageSource	messageSource
static java.lang.String	MIN_CONSTRAINT
static java.lang.String	MIN_SIZE_CONSTRAINT
static java.lang.String	NOT_EQUAL_CONSTRAINT
protected static java.lang.String	NOT_PREFIX
protected static java.lang.String	NOTMET_SUFFIX
static java.lang.String	NULLABLE_CONSTRAINT
protected java.lang.Class<?>	owningClass
protected java.lang.String	propertyName
protected java.lang.Class<?>	propertyType
static java.lang.String	RANGE_CONSTRAINT
static java.lang.String	SCALE_CONSTRAINT
static java.lang.String	SIZE_CONSTRAINT
protected static java.lang.String	TOOBIG_SUFFIX
protected static java.lang.String	TOOLONG_SUFFIX
protected static java.lang.String	TOOSHORT_SUFFIX
protected static java.lang.String	TOOSMALL_SUFFIX
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

Methods

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.Class	getOwner()
java.lang.String	getPropertyName()
java.lang.Class<?>	getPropertyType()
groovy.lang.Range	getRange()
java.lang.Integer	getScale()
groovy.lang.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(org.springframework.context.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(groovy.lang.Range range)
void	setSize(groovy.lang.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, org.springframework.validation.Errors errors) Validate this constrainted property against specified property value

Methods inherited from class java.lang.Object

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

Field Detail

bundle

protected static final java.util.ResourceBundle bundle

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

INVALID_SUFFIX

protected static final java.lang.String INVALID_SUFFIX

See Also:

Constant Field Values

EXCEEDED_SUFFIX

protected static final java.lang.String EXCEEDED_SUFFIX

See Also:

Constant Field Values

NOTMET_SUFFIX

protected static final java.lang.String NOTMET_SUFFIX

See Also:

Constant Field Values

NOT_PREFIX

protected static final java.lang.String NOT_PREFIX

See Also:

Constant Field Values

TOOBIG_SUFFIX

protected static final java.lang.String TOOBIG_SUFFIX

See Also:

Constant Field Values

TOOLONG_SUFFIX

protected static final java.lang.String TOOLONG_SUFFIX

See Also:

Constant Field Values

TOOSMALL_SUFFIX

protected static final java.lang.String TOOSMALL_SUFFIX

See Also:

Constant Field Values

TOOSHORT_SUFFIX

protected static final java.lang.String TOOSHORT_SUFFIX

See Also:

Constant Field Values

constraints

protected static java.util.Map<java.lang.String,java.util.List<java.lang.Object>> constraints

DEFAULT_MESSAGES

protected static final java.util.Map<java.lang.String,java.lang.String> DEFAULT_MESSAGES

LOG

protected static final org.apache.commons.logging.Log LOG

propertyName

protected java.lang.String propertyName

propertyType

protected java.lang.Class<?> propertyType

appliedConstraints

protected java.util.Map<java.lang.String,Constraint> appliedConstraints

owningClass

protected java.lang.Class<?> owningClass

messageSource

protected org.springframework.context.MessageSource messageSource

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)

Specified by:

hasAppliedConstraint in interface grails.validation.Constrained

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()

Specified by:

getPropertyType in interface grails.validation.Constrained

Returns:

Returns the propertyType.

getMax

public java.lang.Comparable getMax()

Specified by:

getMax in interface grails.validation.Constrained

Returns:

Returns the max.

setMax

public void setMax(java.lang.Comparable max)

Parameters:

max - The max to set.

getMin

public java.lang.Comparable getMin()

Specified by:

getMin in interface grails.validation.Constrained

Returns:

Returns the min.

setMin

public void setMin(java.lang.Comparable min)

Parameters:

min - The min to set.

getInList

public java.util.List getInList()

Specified by:

getInList in interface grails.validation.Constrained

Returns:

Returns the inList.

setInList

public void setInList(java.util.List inList)

Parameters:

inList - The inList to set.

getRange

public groovy.lang.Range getRange()

Specified by:

getRange in interface grails.validation.Constrained

Returns:

Returns the range.

setRange

public void setRange(groovy.lang.Range range)

Parameters:

range - The range to set.

getScale

public java.lang.Integer getScale()

Specified by:

getScale in interface grails.validation.Constrained

Returns:

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

getSize

public groovy.lang.Range getSize()

Specified by:

getSize in interface grails.validation.Constrained

Returns:

Returns the size.

setSize

public void setSize(groovy.lang.Range size)

Parameters:

size - The size to set.

isBlank

public boolean isBlank()

Specified by:

isBlank in interface grails.validation.Constrained

Returns:

the blank.

setBlank

public void setBlank(boolean blank)

Parameters:

blank - The blank to set.

isEmail

public boolean isEmail()

Specified by:

isEmail in interface grails.validation.Constrained

Returns:

Returns the email.

setEmail

public void setEmail(boolean email)

Parameters:

email - The email to set.

isCreditCard

public boolean isCreditCard()

Specified by:

isCreditCard in interface grails.validation.Constrained

Returns:

Returns the creditCard.

setCreditCard

public void setCreditCard(boolean creditCard)

Parameters:

creditCard - The creditCard to set.

getMatches

public java.lang.String getMatches()

Specified by:

getMatches in interface grails.validation.Constrained

Returns:

Returns the matches.

setMatches

public void setMatches(java.lang.String regex)

Parameters:

regex - The matches to set.

getNotEqual

public java.lang.Object getNotEqual()

Specified by:

getNotEqual in interface grails.validation.Constrained

Returns:

Returns the notEqual.

getMaxSize

public java.lang.Integer getMaxSize()

Specified by:

getMaxSize in interface grails.validation.Constrained

Returns:

Returns the maxSize.

setMaxSize

public void setMaxSize(java.lang.Integer maxSize)

Parameters:

maxSize - The maxSize to set.

getMinSize

public java.lang.Integer getMinSize()

Specified by:

getMinSize in interface grails.validation.Constrained

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()

Specified by:

isNullable in interface grails.validation.Constrained

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()

Specified by:

isUrl in interface grails.validation.Constrained

Returns:

Returns the url.

setUrl

public void setUrl(boolean url)

Parameters:

url - The url to set.

isDisplay

public boolean isDisplay()

Specified by:

isDisplay in interface grails.validation.Constrained

Returns:

Returns the display.

setDisplay

public void setDisplay(boolean display)

Parameters:

display - The display to set.

isEditable

public boolean isEditable()

Specified by:

isEditable in interface grails.validation.Constrained

Returns:

Returns the editable.

setEditable

public void setEditable(boolean editable)

Parameters:

editable - The editable to set.

getOrder

public int getOrder()

Specified by:

getOrder in interface grails.validation.Constrained

Returns:

Returns the order.

setOrder

public void setOrder(int order)

Parameters:

order - The order to set.

getFormat

public java.lang.String getFormat()

Specified by:

getFormat in interface grails.validation.Constrained

setFormat

public void setFormat(java.lang.String format)

isPassword

public boolean isPassword()

Specified by:

isPassword in interface grails.validation.Constrained

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(org.springframework.context.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,
            org.springframework.validation.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.

Specified by:

supportsContraint in interface grails.validation.Constrained

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.

Specified by:

applyConstraint in interface grails.validation.Constrained

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

getOwner

public java.lang.Class getOwner()

Specified by:

getOwner in interface grails.validation.Constrained

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