org.zkoss.bind.impl

Class ValidationContextImpl

java.lang.Object

org.zkoss.bind.impl.ValidationContextImpl

All Implemented Interfaces:

ValidationContext

public class ValidationContextImpl
extends Object
implements ValidationContext

the default implementation of validation context

Since:

6.0.0

Author:

dennis

Constructor Summary

Constructors

Constructor and Description
ValidationContextImpl(String command, Property property, Map<String,Property[]> properties, BindContext ctx, boolean valid)

Method Summary

Modifier and Type	Method and Description
BindContext	getBindContext()
String	getCommand() get the command that trigger the validation
Map<String,Property[]>	getProperties() get dependent properties that need to be validated.
Map<String,Property>	getProperties(Object base) get dependent properties by a base object.
Property[]	getProperties(String name) get dependent properties by the property name.
Property	getProperty() get the main property that need to be validated.
Object	getValidatorArg(String key) Returns validator arg value of the given key This is a shortcut of getBindContext().getValidatorArg()
boolean	isLocalValid() Checks status of local validation context valid or not, it only relates to one validator.
boolean	isValid() Checks status of validation context valid or not, it is a global status of same command, any validator of this validation phase call ValidationContext.setInvalid() will set this false.
void	setInvalid() set invalid

Methods inherited from class java.lang.Object

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

Constructor Detail

ValidationContextImpl

public ValidationContextImpl(String command,
                             Property property,
                             Map<String,Property[]> properties,
                             BindContext ctx,
                             boolean valid)

Method Detail

getBindContext

public BindContext getBindContext()

Specified by:

getBindContext in interface ValidationContext

Returns:

current bind context

getCommand

public String getCommand()

Description copied from interface: ValidationContext

get the command that trigger the validation

Specified by:

getCommand in interface ValidationContext

Returns:

the command, null if a prompt-save-binding

getProperties

public Map<String,Property[]> getProperties()

Description copied from interface: ValidationContext

get dependent properties that need to be validated. you usually use this method to get value of other properties to do complex validation or a form validation Notice that if the property is under a collection, you would see "$each", which represents "each"

Specified by:

getProperties in interface ValidationContext

Returns:

the properties map.

getProperties

public Property[] getProperties(String name)

Description copied from interface: ValidationContext

get dependent properties by the property name. you usually use this method to get a value of other properties to do complex validation or a form validation Notice that if the property is under a collection, you would see "$each", which represents "each"

Specified by:

getProperties in interface ValidationContext

Parameters:

name - the property name

Returns:

the properties array

getProperties

public Map<String,Property> getProperties(Object base)

Description copied from interface: ValidationContext

get dependent properties by a base object. this method returns a Map (key is the property name) of properties that have same base object. It is useful in the form validation case to get all dependent property that related to a form. For example in a validator of a form,

 Map beanProps = ctx.getProperties(ctx.getProperty().getBase());
 Map formProps = ctx.getProperties(ctx.getProperty().getValue());
 

Notice that if the property is under a collection, you would see "$each", which represents "each"

Specified by:

getProperties in interface ValidationContext

Parameters:

base - the base object of properties

Returns:

a Map of properties that has same base object.

getValidatorArg

public Object getValidatorArg(String key)

Description copied from interface: ValidationContext

Returns validator arg value of the given key This is a shortcut of getBindContext().getValidatorArg()

Specified by:

getValidatorArg in interface ValidationContext

Parameters:

key - the key to the value.

Returns:

value of validator arg of the given key

getProperty

public Property getProperty()

Description copied from interface: ValidationContext

get the main property that need to be validated. Notice that if the property is under a collection, you would see "$each", which represents "each"

Specified by:

getProperty in interface ValidationContext

Returns:

the main property.

isValid

public boolean isValid()

Description copied from interface: ValidationContext

Checks status of validation context valid or not, it is a global status of same command, any validator of this validation phase call ValidationContext.setInvalid() will set this false.

Specified by:

isValid in interface ValidationContext

Returns:

true of result is valid, false if any Validator called ValidationContext.setInvalid(). Note, default is true.

isLocalValid

public boolean isLocalValid()

Description copied from interface: ValidationContext

Checks status of local validation context valid or not, it only relates to one validator.

Specified by:

isLocalValid in interface ValidationContext

Returns:

true of result is valid, false if this Validator called ValidationContext.setInvalid(), default is true.

setInvalid

public void setInvalid()

Description copied from interface: ValidationContext

set invalid

Specified by:

setInvalid in interface ValidationContext