org.zkoss.bind.impl

Class BinderImpl

java.lang.Object

org.zkoss.bind.impl.BinderImpl

All Implemented Interfaces:

Serializable, Binder, BinderCtrl

Direct Known Subclasses:

AnnotateBinder, DefaultBinder

public class BinderImpl
extends Object
implements Binder, BinderCtrl, Serializable

Implementation of Binder.

Since:

6.0.0

Author:

henrichen, dennischen

See Also:

Serialized Form

Field Summary

Fields inherited from interface org.zkoss.bind.Binder

ACCESS, COMMAND_FAIL_VALIDATE, COMMAND_SUCCESS, CONVERTER, LOAD_EVENT, LOAD_REPLACEMENT, LOAD_TYPE, RENDERER, SAVE_EVENT, SAVE_REPLACEMENT, VALIDATOR, ZKBIND

Fields inherited from interface org.zkoss.bind.sys.BinderCtrl

ACTIVATOR, BINDCTX, BINDER, BINDING, BINDRENDERING, CHILDREN_ATTR, CHILDREN_BINDING_MODEL, CHILDREN_BINDING_MODEL_LISTENER, CHILDREN_BINDING_RENDERED_COMPONENTS, CLIENT_INFO, CLIENT_UPLOAD_INFO, DEFAULT_QUEUE_NAME, DEFAULT_QUEUE_SCOPE, DEPENDS_ON_COMP, FORM_ID, IGNORE_REF_VALUE, IGNORE_TRACKER, INVALIDATE_REF_VALUE, IS_TEMPLATE_MODEL_ENABLED_ATTR, LOAD_FORM_COMPONENT, LOAD_FORM_EXPRESSION, MATCHMEDIAVALUE_PREFIX, MODEL, NOTIFYS, ON_BIND_CLEAN, ON_BIND_INIT, PHASE_LISTENER_CLASS_KEY, REMOVE_BINDINGS, RENDERER_INSTALLED, SAVE_BASE, SRCPATH, VALIDATES, VAR, VIEWMODELID_BINDER_MAP_KEY, VM

Constructor Summary

Constructors

Constructor and Description
BinderImpl()
BinderImpl(String qname, String qscope)

Method Summary

Modifier and Type	Method and Description
void	addChildrenInitBinding(org.zkoss.zk.ui.Component comp, String initExpr, Map<String,Object> initArgs) Deprecated.
void	addChildrenInitBinding(org.zkoss.zk.ui.Component comp, String initExpr, Map<String,Object> initArgs, String converterExpr, Map<String,Object> converterArgs) init children of a component by an expression, it only execute once
void	addChildrenLoadBindings(org.zkoss.zk.ui.Component comp, String loadExpr, String[] beforeCmds, String[] afterCmds, Map<String,Object> bindingArgs) Deprecated.
void	addChildrenLoadBindings(org.zkoss.zk.ui.Component comp, String loadExpr, String[] beforeCmds, String[] afterCmds, Map<String,Object> bindingArgs, String converterExpr, Map<String,Object> converterArgs) Add new children-load-bindings.
void	addCommandBinding(org.zkoss.zk.ui.Component comp, String evtnm, String commandExpr, Map<String,Object> args) Add a new command binding.
void	addFormAssociatedSaveBinding(org.zkoss.zk.ui.Component associatedComp, String formId, SaveBinding saveBinding, String fieldName) Add a association between formId and a associated save binding(save binding inside a form), the form has to exist in the parent components
void	addFormInitBinding(org.zkoss.zk.ui.Component comp, String id, String initExpr, Map<String,Object> initArgs) init a component form by expression, it only execute once
void	addFormLoadBindings(org.zkoss.zk.ui.Component comp, String id, String loadExpr, String[] beforeCmds, String[] afterCmds, Map<String,Object> bindingArgs) Add new form-load-bindings.
void	addFormSaveBindings(org.zkoss.zk.ui.Component comp, String id, String saveExpr, String[] beforeCmds, String[] afterCmds, Map<String,Object> bindingArgs, String validatorExpr, Map<String,Object> validatorArgs) Add new form-save-bindings.
void	addGlobalCommandBinding(org.zkoss.zk.ui.Component comp, String evtnm, String commandExpr, Map<String,Object> args) Add a new global-command binding.
void	addPhaseListener(PhaseListener listener) Add the PhaseListener
void	addPropertyInitBinding(org.zkoss.zk.ui.Component comp, String attr, String initExpr, Map<String,Object> initArgs, String converterExpr, Map<String,Object> converterArgs) init a component property by a expression, it only execute once
void	addPropertyLoadBindings(org.zkoss.zk.ui.Component comp, String attr, String loadExpr, String[] beforeCmds, String[] afterCmds, Map<String,Object> bindingArgs, String converterExpr, Map<String,Object> converterArgs) Add new property-load-bindings.
void	addPropertySaveBindings(org.zkoss.zk.ui.Component comp, String attr, String saveExpr, String[] beforeCmds, String[] afterCmds, Map<String,Object> bindingArgs, String converterExpr, Map<String,Object> converterArgs, String validatorExpr, Map<String,Object> validatorArgs) Add new property-save-bindings.
void	addReferenceBinding(org.zkoss.zk.ui.Component comp, String attr, String loadExpr, Map<String,Object> bindingArgs) Add a new reference-binding.
void	addSaveFormFieldName(Form form, Set<String> fieldNames) Adds all field names for saving with the given Form.
void	addSaveFormFieldName(Form form, String fieldName) Adds a field name for saving with the given Form.
protected void	checkInit()
protected ParamCall	createParamCall(BindContext ctx)
void	destroy(org.zkoss.zk.ui.Component comp, Object viewModel) Destroys the binder with a root component and viewModel object.
protected void	doExecute(org.zkoss.zk.ui.Component comp, String command, Map<String,Object> commandArgs, BindContext ctx, Set<Property> notifys)
protected void	doLoadAfter(org.zkoss.zk.ui.Component comp, String command, BindContext ctx)
protected void	doLoadBefore(org.zkoss.zk.ui.Component comp, String command, BindContext ctx)
protected void	doSaveAfter(org.zkoss.zk.ui.Component comp, String command, org.zkoss.zk.ui.event.Event evt, BindContext ctx, Set<Property> notifys)
protected void	doSaveBefore(org.zkoss.zk.ui.Component comp, String command, org.zkoss.zk.ui.event.Event evt, BindContext ctx, Set<Property> notifys)
protected boolean	doValidate(org.zkoss.zk.ui.Component comp, String command, org.zkoss.zk.ui.event.Event evt, BindContext ctx, Set<Property> notifys)
protected void	fireNotifyChanges(Set<Property> notifys)
BindingAnnotationInfoChecker	getBindingAnnotationInfoChecker() get binding annotation info checker
BindingExecutionInfoCollector	getBindingExecutionInfoCollector() get binding execution info collector
Map<String,List<Binding>>	getBindings(org.zkoss.zk.ui.Component comp)
Converter	getConverter(String name) Returns the _converter of the given _converter name.
Map<String,Object>	getDynamicAttrs() Internal use only.
BindEvaluatorX	getEvaluatorX() Returns the BindEvaluatorX used by this Binder.
protected org.zkoss.zk.ui.event.EventQueue<org.zkoss.zk.ui.event.Event>	getEventQueue()
Form	getForm(org.zkoss.zk.ui.Component comp, String id) Get the form of the component
Set<SaveBinding>	getFormAssociatedSaveBindings(org.zkoss.zk.ui.Component comp) Get associated save bindings of a form in a component
List<Binding>	getLoadPromptBindings(org.zkoss.zk.ui.Component comp, String attr) get all load prompt binding of the component and attribute
Map<String,Method>	getMatchMediaValue() Returns an unmodifiable Map containing all the MatchMedia annotation values of this binder.
PhaseListener	getPhaseListener() get the first PhaseListener
List<PhaseListener>	getPhaseListeners() get the first PhaseListener
String	getQueueName() Returns the queue name of this binder
String	getQueueScope() Returns the queue scope of this binder
protected Object	getRenderer(String name)
Set<String>	getSaveFormFieldNames(Form form) Returns all field names for saving with the given Form.
TemplateResolver	getTemplateResolver(org.zkoss.zk.ui.Component comp, String attr) get the template resolver that sets by Binder.setTemplate(Component, String, String, java.util.Map)
Tracker	getTracker() Returns associated dependency tracker of this binder.
ValidationMessages	getValidationMessages() Get the ValidationMessages
Validator	getValidator(String name) Returns the _validator of the given _validator name.
org.zkoss.zk.ui.Component	getView() Returns associated root component of this binder.
Object	getViewModel() Returns associated ViewModel of this binder.
boolean	hasValidator(org.zkoss.zk.ui.Component comp, String attr) is there a validator on the attribute of component
void	init(org.zkoss.zk.ui.Component comp, Object viewModel) Deprecated. use init(Component, Object, Map) instead
void	init(org.zkoss.zk.ui.Component comp, Object viewModel, Map<String,Object> initArgs) Initializes the binder with a root component and viewModel object.
void	initActivator() Internal use only.
void	initQueue() Internal use only.
boolean	isActivating() check if binder is in activating state
void	loadComponent(org.zkoss.zk.ui.Component comp, boolean loadinit) Internal Use only.
protected void	loadComponent0(org.zkoss.zk.ui.Component comp, boolean loadinit)
protected CommandBinding	newCommandBinding(org.zkoss.zk.ui.Component comp, String evtnm, String cmdScript, Map<String,Object> args) Make this extenable.
protected InitChildrenBinding	newInitChildrenBinding(org.zkoss.zk.ui.Component comp, String initExpr, Map<String,Object> bindingArgs, String converterExpr, Map<String,Object> converterArgs) Make this extenable.
protected InitFormBinding	newInitFormBinding(org.zkoss.zk.ui.Component comp, String formId, String initExpr, Map<String,Object> bindingArgs) Make this extenable.
protected InitPropertyBinding	newInitPropertyBinding(org.zkoss.zk.ui.Component comp, String attr, String loadAttr, Class<?> attrType, String initExpr, Map<String,Object> bindingArgs, String converterExpr, Map<String,Object> converterArgs) Make this extenable.
protected LoadChildrenBinding	newLoadChildrenBinding(org.zkoss.zk.ui.Component comp, String loadExpr, ConditionType conditionType, String command, Map<String,Object> bindingArgs, String converterExpr, Map<String,Object> converterArgs) Make this extenable.
protected LoadFormBinding	newLoadFormBinding(org.zkoss.zk.ui.Component comp, String formId, String loadExpr, ConditionType conditionType, String command, Map<String,Object> bindingArgs) Make this extenable.
protected LoadPropertyBinding	newLoadPropertyBinding(org.zkoss.zk.ui.Component comp, String attr, String loadAttr, Class<?> attrType, String loadExpr, ConditionType conditionType, String command, Map<String,Object> bindingArgs, String converterExpr, Map<String,Object> converterArgs) Make this extenable.
protected SaveFormBinding	newSaveFormBinding(org.zkoss.zk.ui.Component comp, String formId, String saveExpr, ConditionType conditionType, String command, Map<String,Object> bindingArgs, String validatorExpr, Map<String,Object> validatorArgs) Make this extenable.
protected SavePropertyBinding	newSavePropertyBinding(org.zkoss.zk.ui.Component comp, String attr, String saveAttr, String saveExpr, ConditionType conditionType, String command, Map<String,Object> bindingArgs, String converterExpr, Map<String,Object> converterArgs, String validatorExpr, Map<String,Object> validatorArgs) Make this extenable.
void	notifyChange(Object base, String attr) Notify change of the property.
void	postCommand(String command, Map<String,Object> args) post command this binder, binder will queue the command, and fired later.
void	removeBindings(org.zkoss.zk.ui.Component comp) Remove all bindings that associated with the specified component.
void	removeBindings(org.zkoss.zk.ui.Component comp, String key) Remove all bindings that associated with the specified component and key (_fieldExpr|evtnm|formid).
void	removeBindings(Set<org.zkoss.zk.ui.Component> comps) Remove all managed bindings that associated with the specified components.
Set<String>	removeSaveFormFieldNames(Form self) Remove all field names for saving with the given Form.
int	sendCommand(String command, Map<String,Object> args) send command fired to this binder and process the command immediately
void	setDynamicAttrs(String command, Object value) Internal use only.
void	setPhaseListener(PhaseListener listener) Sets the associated phase listener to intervene the binding life cycle.
void	setTemplate(org.zkoss.zk.ui.Component comp, String attr, String templateExpr, Map<String,Object> templateArgs) set template to a component property by an expression
void	setValidationMessages(ValidationMessages messages) Set the ValidationMessages
void	setViewModel(Object vm) Sets associated ViewModel of this binder.
void	storeForm(org.zkoss.zk.ui.Component comp, String id, Form form) Store the form in the component with id

Methods inherited from class java.lang.Object

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

Constructor Detail

BinderImpl

public BinderImpl()

BinderImpl

public BinderImpl(String qname,
                  String qscope)

Method Detail

init

public void init(org.zkoss.zk.ui.Component comp,
                 Object viewModel)

Deprecated. use init(Component, Object, Map) instead

Description copied from interface: Binder

Initializes the binder with a root component and viewModel object. You should never call this if you use AnnotateBinder and zk annotation

Specified by:

init in interface Binder

Parameters:

comp - root component of binder

viewModel - viewModel object

init

public void init(org.zkoss.zk.ui.Component comp,
                 Object viewModel,
                 Map<String,Object> initArgs)

Description copied from interface: Binder

Initializes the binder with a root component and viewModel object. You should never call this if you use AnnotateBinder and zk annotation

Specified by:

init in interface Binder

Parameters:

comp - root component of binder

viewModel - viewModel object

initArgs - args key-value pairs for initial, nullable

Since:

6.0.1

destroy

public void destroy(org.zkoss.zk.ui.Component comp,
                    Object viewModel)

Description copied from interface: Binder

Destroys the binder with a root component and viewModel object. You should never call this if you use AnnotateBinder and zk annotation

Specified by:

destroy in interface Binder

Parameters:

comp - root component of binder

viewModel - viewModel object

checkInit

protected void checkInit()

getBindings

public Map<String,List<Binding>> getBindings(org.zkoss.zk.ui.Component comp)

setViewModel

public void setViewModel(Object vm)

Description copied from interface: Binder

Sets associated ViewModel of this binder.

Specified by:

setViewModel in interface Binder

Parameters:

vm - the associated view model of this binder.

getViewModel

public Object getViewModel()

Description copied from interface: Binder

Returns associated ViewModel of this binder.

Specified by:

getViewModel in interface Binder

Returns:

associated ViewModel of this binder.

getConverter

public Converter getConverter(String name)

Description copied from interface: Binder

Returns the _converter of the given _converter name.

Specified by:

getConverter in interface Binder

Parameters:

name - _converter name

Returns:

the _converter of the given _converter name.

getValidator

public Validator getValidator(String name)

Description copied from interface: Binder

Returns the _validator of the given _validator name.

Specified by:

getValidator in interface Binder

Parameters:

name - _validator name

Returns:

the _validator of the given _validator name.

getRenderer

protected Object getRenderer(String name)

getEvaluatorX

public BindEvaluatorX getEvaluatorX()

Description copied from interface: Binder

Returns the BindEvaluatorX used by this Binder.

Specified by:

getEvaluatorX in interface Binder

Returns:

the EvaluatorX.

storeForm

public void storeForm(org.zkoss.zk.ui.Component comp,
                      String id,
                      Form form)

Description copied from interface: BinderCtrl

Store the form in the component with id

Specified by:

storeForm in interface BinderCtrl

Parameters:

comp - the component to store the form

id - the form id

form - the form instance

getForm

public Form getForm(org.zkoss.zk.ui.Component comp,
                    String id)

Description copied from interface: BinderCtrl

Get the form of the component

Specified by:

getForm in interface BinderCtrl

Parameters:

comp - the component has the form

id - the form id

Returns:

the form if there is a form inside the component with the id

addFormInitBinding

public void addFormInitBinding(org.zkoss.zk.ui.Component comp,
                               String id,
                               String initExpr,
                               Map<String,Object> initArgs)

Description copied from interface: Binder

init a component form by expression, it only execute once

Specified by:

addFormInitBinding in interface Binder

Parameters:

comp - the associated component, must not null

id - the form id, must not null

initExpr - init expression, nullable

initArgs - args key-value pairs for this init, nullable

addFormLoadBindings

public void addFormLoadBindings(org.zkoss.zk.ui.Component comp,
                                String id,
                                String loadExpr,
                                String[] beforeCmds,
                                String[] afterCmds,
                                Map<String,Object> bindingArgs)

Description copied from interface: Binder

Add new form-load-bindings. It create a prompt|conditional form-load-binding depends on beforeCmds and afterCmds. If both beforeCmds and afterCmds are null or empty, it create a prompt binding.

Specified by:

addFormLoadBindings in interface Binder

Parameters:

comp - the associated component, must not null

id - the form id, must not null

loadExpr - load expression, nullable

beforeCmds - load before these commands, the command here is not a EL expression. nullable

afterCmds - load after these commands, the command here is not a EL expression. nullable

bindingArgs - args key-value pairs for this binding, nullable

addFormSaveBindings

public void addFormSaveBindings(org.zkoss.zk.ui.Component comp,
                                String id,
                                String saveExpr,
                                String[] beforeCmds,
                                String[] afterCmds,
                                Map<String,Object> bindingArgs,
                                String validatorExpr,
                                Map<String,Object> validatorArgs)

Description copied from interface: Binder

Add new form-save-bindings. It create a conditional form-save-binding depends on beforeCmds and afterCmds. Since form-save-binding is always triggered by command, if both beforeCmds and afterCmds are null or empty, it throws an exception.

Specified by:

addFormSaveBindings in interface Binder

Parameters:

comp - the associated component, must not null

id - the form id, must not null

saveExpr - save expression, nullable

beforeCmds - save before these commands, the command here is not a EL expression. nullable

afterCmds - save after these commands, the command here is not a EL expression. nullable

bindingArgs - args key-value pairs for this binding, nullable

validatorExpr - the converter expression, nullable

validatorArgs - args key-value pairs for validator, nullable

addPropertyInitBinding

public void addPropertyInitBinding(org.zkoss.zk.ui.Component comp,
                                   String attr,
                                   String initExpr,
                                   Map<String,Object> initArgs,
                                   String converterExpr,
                                   Map<String,Object> converterArgs)

Description copied from interface: Binder

init a component property by a expression, it only execute once

Specified by:

addPropertyInitBinding in interface Binder

Parameters:

comp - the associated component, must not null

attr - the associated attribute of the component; ex label, style, must not null

initExpr - init expression, must not null

initArgs - args key-value pairs for initial, nullable

converterExpr - the converter expression, nullable

converterArgs - args key-value pairs for converter, nullable

addPropertyLoadBindings

public void addPropertyLoadBindings(org.zkoss.zk.ui.Component comp,
                                    String attr,
                                    String loadExpr,
                                    String[] beforeCmds,
                                    String[] afterCmds,
                                    Map<String,Object> bindingArgs,
                                    String converterExpr,
                                    Map<String,Object> converterArgs)

Description copied from interface: Binder

Add new property-load-bindings. It creates a prompt|conditional property-load-binding depends on beforeCmds and afterCmds. If both beforeCmds and afterCmds are null or empty, it create a prompt binding.

Specified by:

addPropertyLoadBindings in interface Binder

Parameters:

comp - the associated component, must not null

attr - the associated attribute of the component; ex label, style, must not null

loadExpr - load expression, must not null

beforeCmds - load before these commands, the command here is not a EL expression. nullable

afterCmds - load after these commands, the command here is not a EL expression. nullable

bindingArgs - args key-value pairs for this binding, nullable

converterExpr - the converter expression, nullable

converterArgs - args key-value pairs for converter, nullable

addPropertySaveBindings

public void addPropertySaveBindings(org.zkoss.zk.ui.Component comp,
                                    String attr,
                                    String saveExpr,
                                    String[] beforeCmds,
                                    String[] afterCmds,
                                    Map<String,Object> bindingArgs,
                                    String converterExpr,
                                    Map<String,Object> converterArgs,
                                    String validatorExpr,
                                    Map<String,Object> validatorArgs)

Description copied from interface: Binder

Add new property-save-bindings. It creates a prompt|conditional property-save-binding depends on beforeCmds and afterCmds. If both beforeCmds and afterCmds are null or empty, it create a prompt binding.

Specified by:

addPropertySaveBindings in interface Binder

Parameters:

comp - the associated component, must not null

attr - the associated attribute of the component; ex value, check, must not null

saveExpr - save expression, nullable

beforeCmds - save before these commands, the command here is not a EL expression. nullable

afterCmds - save after these commands, the command here is not a EL expression. nullable

bindingArgs - args key-value pairs for this binding, nullable

converterExpr - the converter expression, nullable

converterArgs - args key-value pairs for converter, nullable

validatorExpr - the converter expression, nullable

validatorArgs - args key-value pairs for validator, nullable

newLoadPropertyBinding

protected LoadPropertyBinding newLoadPropertyBinding(org.zkoss.zk.ui.Component comp,
                                                     String attr,
                                                     String loadAttr,
                                                     Class<?> attrType,
                                                     String loadExpr,
                                                     ConditionType conditionType,
                                                     String command,
                                                     Map<String,Object> bindingArgs,
                                                     String converterExpr,
                                                     Map<String,Object> converterArgs)

Make this extenable.

Since:

7.0.3

newSavePropertyBinding

protected SavePropertyBinding newSavePropertyBinding(org.zkoss.zk.ui.Component comp,
                                                     String attr,
                                                     String saveAttr,
                                                     String saveExpr,
                                                     ConditionType conditionType,
                                                     String command,
                                                     Map<String,Object> bindingArgs,
                                                     String converterExpr,
                                                     Map<String,Object> converterArgs,
                                                     String validatorExpr,
                                                     Map<String,Object> validatorArgs)

Make this extenable.

Since:

7.0.3

newInitPropertyBinding

protected InitPropertyBinding newInitPropertyBinding(org.zkoss.zk.ui.Component comp,
                                                     String attr,
                                                     String loadAttr,
                                                     Class<?> attrType,
                                                     String initExpr,
                                                     Map<String,Object> bindingArgs,
                                                     String converterExpr,
                                                     Map<String,Object> converterArgs)

Make this extenable.

Since:

7.0.3

newInitChildrenBinding

protected InitChildrenBinding newInitChildrenBinding(org.zkoss.zk.ui.Component comp,
                                                     String initExpr,
                                                     Map<String,Object> bindingArgs,
                                                     String converterExpr,
                                                     Map<String,Object> converterArgs)

Make this extenable.

Since:

7.0.3

newLoadChildrenBinding

protected LoadChildrenBinding newLoadChildrenBinding(org.zkoss.zk.ui.Component comp,
                                                     String loadExpr,
                                                     ConditionType conditionType,
                                                     String command,
                                                     Map<String,Object> bindingArgs,
                                                     String converterExpr,
                                                     Map<String,Object> converterArgs)

Make this extenable.

Since:

7.0.3

newCommandBinding

protected CommandBinding newCommandBinding(org.zkoss.zk.ui.Component comp,
                                           String evtnm,
                                           String cmdScript,
                                           Map<String,Object> args)

Make this extenable.

Since:

7.0.3

newInitFormBinding

protected InitFormBinding newInitFormBinding(org.zkoss.zk.ui.Component comp,
                                             String formId,
                                             String initExpr,
                                             Map<String,Object> bindingArgs)

Make this extenable.

Since:

7.0.3

newLoadFormBinding

protected LoadFormBinding newLoadFormBinding(org.zkoss.zk.ui.Component comp,
                                             String formId,
                                             String loadExpr,
                                             ConditionType conditionType,
                                             String command,
                                             Map<String,Object> bindingArgs)

Make this extenable.

Since:

7.0.3

newSaveFormBinding

protected SaveFormBinding newSaveFormBinding(org.zkoss.zk.ui.Component comp,
                                             String formId,
                                             String saveExpr,
                                             ConditionType conditionType,
                                             String command,
                                             Map<String,Object> bindingArgs,
                                             String validatorExpr,
                                             Map<String,Object> validatorArgs)

Make this extenable.

Since:

7.0.3

addChildrenInitBinding

@Deprecated
public void addChildrenInitBinding(org.zkoss.zk.ui.Component comp,
                                               String initExpr,
                                               Map<String,Object> initArgs)

Deprecated.

Description copied from interface: Binder

init children of a component by an expression, it only execute once

Specified by:

addChildrenInitBinding in interface Binder

Parameters:

comp - the associated component, must not null

initExpr - init expression, must not null

initArgs - args key-value pairs for initial, nullable

addChildrenInitBinding

public void addChildrenInitBinding(org.zkoss.zk.ui.Component comp,
                                   String initExpr,
                                   Map<String,Object> initArgs,
                                   String converterExpr,
                                   Map<String,Object> converterArgs)

Description copied from interface: Binder

init children of a component by an expression, it only execute once

Specified by:

addChildrenInitBinding in interface Binder

Parameters:

comp - the associated component, must not null

initExpr - init expression, must not null

initArgs - args key-value pairs for initial, nullable

converterExpr - the converter expression, nullable

converterArgs - args key-value pairs for converter, nullable

addChildrenLoadBindings

@Deprecated
public void addChildrenLoadBindings(org.zkoss.zk.ui.Component comp,
                                                String loadExpr,
                                                String[] beforeCmds,
                                                String[] afterCmds,
                                                Map<String,Object> bindingArgs)

Deprecated.

Description copied from interface: Binder

Add new children-load-bindings. It creates a prompt|conditional children-load-binding depends on beforeCmds and afterCmds. If both beforeCmds and afterCmds are null or empty, it create a prompt binding.

Specified by:

addChildrenLoadBindings in interface Binder

Parameters:

comp - the associated component, must not null

loadExpr - load expression, must not null

beforeCmds - load before these commands, the command here is not a EL expression. nullable

afterCmds - load after these commands, the command here is not a EL expression. nullable

bindingArgs - args key-value pairs for this binding, nullable

addChildrenLoadBindings

public void addChildrenLoadBindings(org.zkoss.zk.ui.Component comp,
                                    String loadExpr,
                                    String[] beforeCmds,
                                    String[] afterCmds,
                                    Map<String,Object> bindingArgs,
                                    String converterExpr,
                                    Map<String,Object> converterArgs)

Description copied from interface: Binder

Add new children-load-bindings. It creates a prompt|conditional children-load-binding depends on beforeCmds and afterCmds. If both beforeCmds and afterCmds are null or empty, it create a prompt binding.

Specified by:

addChildrenLoadBindings in interface Binder

Parameters:

comp - the associated component, must not null

loadExpr - load expression, must not null

beforeCmds - load before these commands, the command here is not a EL expression. nullable

afterCmds - load after these commands, the command here is not a EL expression. nullable

bindingArgs - args key-value pairs for this binding, nullable

converterExpr - the converter expression, nullable

converterArgs - args key-value pairs for converter, nullable

addReferenceBinding

public void addReferenceBinding(org.zkoss.zk.ui.Component comp,
                                String attr,
                                String loadExpr,
                                Map<String,Object> bindingArgs)

Description copied from interface: Binder

Add a new reference-binding. It creates an attribute as the reference of the expression in the component.

Specified by:

addReferenceBinding in interface Binder

Parameters:

comp - the associated component, must not null

attr - the name of reference that stored in the component; ex myval, must not null

loadExpr - load expression, must not null

bindingArgs - args key-value pairs for this binding, nullable

addCommandBinding

public void addCommandBinding(org.zkoss.zk.ui.Component comp,
                              String evtnm,
                              String commandExpr,
                              Map<String,Object> args)

Description copied from interface: Binder

Add a new command binding.

Specified by:

addCommandBinding in interface Binder

Parameters:

comp - the associated component

evtnm - the associated component event name

commandExpr - the command expression

args - other key-value pairs pairs for command

addGlobalCommandBinding

public void addGlobalCommandBinding(org.zkoss.zk.ui.Component comp,
                                    String evtnm,
                                    String commandExpr,
                                    Map<String,Object> args)

Description copied from interface: Binder

Add a new global-command binding.

Specified by:

addGlobalCommandBinding in interface Binder

Parameters:

comp - the associated component

evtnm - the associated component event name

commandExpr - the command expression

args - other key-value pairs pairs for command

isActivating

public boolean isActivating()

Description copied from interface: BinderCtrl

check if binder is in activating state

Specified by:

isActivating in interface BinderCtrl

Returns:

true if binder is currently in activating state

Since:

6.0.1

sendCommand

public int sendCommand(String command,
                       Map<String,Object> args)

Description copied from interface: Binder

send command fired to this binder and process the command immediately

Specified by:

sendCommand in interface Binder

Parameters:

command - command name

args - , arguments when notifying this command, it will be passed as a arguments of execution method of vm

Returns:

the result of the doCommand, COMMAND_SUCCESS or COMMAND_FAIL_VALIDATE (since 8.0.1)

fireNotifyChanges

protected void fireNotifyChanges(Set<Property> notifys)

postCommand

public void postCommand(String command,
                        Map<String,Object> args)

Description copied from interface: Binder

post command this binder, binder will queue the command, and fired later.

Specified by:

postCommand in interface Binder

Parameters:

command - command name

args - , arguments when notifying this command, it will be passed as a arguments of execution method of vm

doValidate

protected boolean doValidate(org.zkoss.zk.ui.Component comp,
                             String command,
                             org.zkoss.zk.ui.event.Event evt,
                             BindContext ctx,
                             Set<Property> notifys)

createParamCall

protected ParamCall createParamCall(BindContext ctx)

doExecute

protected void doExecute(org.zkoss.zk.ui.Component comp,
                         String command,
                         Map<String,Object> commandArgs,
                         BindContext ctx,
                         Set<Property> notifys)

doSaveBefore

protected void doSaveBefore(org.zkoss.zk.ui.Component comp,
                            String command,
                            org.zkoss.zk.ui.event.Event evt,
                            BindContext ctx,
                            Set<Property> notifys)

doSaveAfter

protected void doSaveAfter(org.zkoss.zk.ui.Component comp,
                           String command,
                           org.zkoss.zk.ui.event.Event evt,
                           BindContext ctx,
                           Set<Property> notifys)

doLoadBefore

protected void doLoadBefore(org.zkoss.zk.ui.Component comp,
                            String command,
                            BindContext ctx)

doLoadAfter

protected void doLoadAfter(org.zkoss.zk.ui.Component comp,
                           String command,
                           BindContext ctx)

removeBindings

public void removeBindings(Set<org.zkoss.zk.ui.Component> comps)

Description copied from interface: Binder

Remove all managed bindings that associated with the specified components.

Specified by:

removeBindings in interface Binder

removeBindings

public void removeBindings(org.zkoss.zk.ui.Component comp)

Remove all bindings that associated with the specified component.

Specified by:

removeBindings in interface Binder

Parameters:

comp - the component

removeBindings

public void removeBindings(org.zkoss.zk.ui.Component comp,
                           String key)

Remove all bindings that associated with the specified component and key (_fieldExpr|evtnm|formid).

Specified by:

removeBindings in interface Binder

Parameters:

comp - the component

key - can be component attribute, event name, or form id

getLoadPromptBindings

public List<Binding> getLoadPromptBindings(org.zkoss.zk.ui.Component comp,
                                           String attr)

Description copied from interface: BinderCtrl

get all load prompt binding of the component and attribute

Specified by:

getLoadPromptBindings in interface BinderCtrl

Parameters:

comp - the component is relative to the bindings

attr - the attribute is relative to the bindings

Returns:

the prompt-load-bindings

setTemplate

public void setTemplate(org.zkoss.zk.ui.Component comp,
                        String attr,
                        String templateExpr,
                        Map<String,Object> templateArgs)

Description copied from interface: Binder

set template to a component property by an expression

Specified by:

setTemplate in interface Binder

Parameters:

comp - the associated component, must not null

attr - the associated attribute of the component; ex label, style, must not null

templateExpr - template expression, must not null

templateArgs - args key-value pairs for template, nullable

getTemplateResolver

public TemplateResolver getTemplateResolver(org.zkoss.zk.ui.Component comp,
                                            String attr)

Description copied from interface: BinderCtrl

get the template resolver that sets by Binder.setTemplate(Component, String, String, java.util.Map)

Specified by:

getTemplateResolver in interface BinderCtrl

Parameters:

comp - the component has resolvers

attr - the attribute to get the resolver

Returns:

the resolver, null if not existed.

getTracker

public Tracker getTracker()

Description copied from interface: BinderCtrl

Returns associated dependency tracker of this binder.

Specified by:

getTracker in interface BinderCtrl

Returns:

associated dependency tracker of this binder.

loadComponent

public void loadComponent(org.zkoss.zk.ui.Component comp,
                          boolean loadinit)

Internal Use only. init and load the component

Specified by:

loadComponent in interface Binder

Parameters:

comp - the component to reload

loadinit - true if should also load the init-binding

getDynamicAttrs

public Map<String,Object> getDynamicAttrs()

Internal use only.

Since:

8.0.0

setDynamicAttrs

public void setDynamicAttrs(String command,
                            Object value)

Internal use only.

Since:

8.0.0

loadComponent0

protected void loadComponent0(org.zkoss.zk.ui.Component comp,
                              boolean loadinit)

notifyChange

public void notifyChange(Object base,
                         String attr)

Description copied from interface: Binder

Notify change of the property.

Specified by:

notifyChange in interface Binder

Parameters:

base - the backing bean object.

attr - the property of the bean that change the value

setPhaseListener

public void setPhaseListener(PhaseListener listener)

Description copied from interface: Binder

Sets the associated phase listener to intervene the binding life cycle.

Specified by:

setPhaseListener in interface Binder

Specified by:

setPhaseListener in interface BinderCtrl

Parameters:

listener - the associated phase listener.

addPhaseListener

public void addPhaseListener(PhaseListener listener)

Description copied from interface: BinderCtrl

Add the PhaseListener

Specified by:

addPhaseListener in interface BinderCtrl

getPhaseListener

public PhaseListener getPhaseListener()

Description copied from interface: BinderCtrl

get the first PhaseListener

Specified by:

getPhaseListener in interface BinderCtrl

Returns:

the PhaseListener

getPhaseListeners

public List<PhaseListener> getPhaseListeners()

Description copied from interface: BinderCtrl

get the first PhaseListener

Specified by:

getPhaseListeners in interface BinderCtrl

Returns:

the PhaseListener

getEventQueue

protected org.zkoss.zk.ui.event.EventQueue<org.zkoss.zk.ui.event.Event> getEventQueue()

addFormAssociatedSaveBinding

public void addFormAssociatedSaveBinding(org.zkoss.zk.ui.Component associatedComp,
                                         String formId,
                                         SaveBinding saveBinding,
                                         String fieldName)

Description copied from interface: BinderCtrl

Add a association between formId and a associated save binding(save binding inside a form), the form has to exist in the parent components

Specified by:

addFormAssociatedSaveBinding in interface BinderCtrl

Parameters:

associatedComp - associated component inside a form binding

formId - the form id

saveBinding - the nested save binding in side a form binding

fieldName - the associated form fieldName for the associated save binding

getFormAssociatedSaveBindings

public Set<SaveBinding> getFormAssociatedSaveBindings(org.zkoss.zk.ui.Component comp)

Description copied from interface: BinderCtrl

Get associated save bindings of a form in a component

Specified by:

getFormAssociatedSaveBindings in interface BinderCtrl

Parameters:

comp - the component that contains the form

Returns:

all associated save binding in the form

hasValidator

public boolean hasValidator(org.zkoss.zk.ui.Component comp,
                            String attr)

Description copied from interface: BinderCtrl

is there a validator on the attribute of component

Specified by:

hasValidator in interface BinderCtrl

Parameters:

comp - the component to check

attr - the attribute to check

Returns:

true if there is a validator

getView

public org.zkoss.zk.ui.Component getView()

Description copied from interface: Binder

Returns associated root component of this binder.

Specified by:

getView in interface Binder

Returns:

associated root component of this binder.

getValidationMessages

public ValidationMessages getValidationMessages()

Description copied from interface: BinderCtrl

Get the ValidationMessages

Specified by:

getValidationMessages in interface BinderCtrl

Returns:

null if no one set the instance by BinderCtrl.setValidationMessages(ValidationMessages)

setValidationMessages

public void setValidationMessages(ValidationMessages messages)

Description copied from interface: BinderCtrl

Set the ValidationMessages

Specified by:

setValidationMessages in interface BinderCtrl

Parameters:

messages - the ValidationMessages

getBindingExecutionInfoCollector

public BindingExecutionInfoCollector getBindingExecutionInfoCollector()

Description copied from interface: BinderCtrl

get binding execution info collector

Specified by:

getBindingExecutionInfoCollector in interface BinderCtrl

Returns:

the collector instance or null if no collector is existed

getBindingAnnotationInfoChecker

public BindingAnnotationInfoChecker getBindingAnnotationInfoChecker()

Description copied from interface: BinderCtrl

get binding annotation info checker

Specified by:

getBindingAnnotationInfoChecker in interface BinderCtrl

Returns:

the collector instance or null if no collector is existed

getQueueName

public String getQueueName()

Description copied from interface: BinderCtrl

Returns the queue name of this binder

Specified by:

getQueueName in interface BinderCtrl

getQueueScope

public String getQueueScope()

Description copied from interface: BinderCtrl

Returns the queue scope of this binder

Specified by:

getQueueScope in interface BinderCtrl

getMatchMediaValue

public Map<String,Method> getMatchMediaValue()

Description copied from interface: BinderCtrl

Returns an unmodifiable Map containing all the MatchMedia annotation values of this binder. If there's no MatchMedia annotation, it returns an empty Map.

Specified by:

getMatchMediaValue in interface BinderCtrl

addSaveFormFieldName

public void addSaveFormFieldName(Form form,
                                 String fieldName)

Description copied from interface: BinderCtrl

Adds a field name for saving with the given Form.

Specified by:

addSaveFormFieldName in interface BinderCtrl

fieldName - field name to be saved into.

addSaveFormFieldName

public void addSaveFormFieldName(Form form,
                                 Set<String> fieldNames)

Description copied from interface: BinderCtrl

Adds all field names for saving with the given Form.

Specified by:

addSaveFormFieldName in interface BinderCtrl

fieldNames - field name to be saved into.

removeSaveFormFieldNames

public Set<String> removeSaveFormFieldNames(Form self)

Description copied from interface: BinderCtrl

Remove all field names for saving with the given Form.

Specified by:

removeSaveFormFieldNames in interface BinderCtrl

getSaveFormFieldNames

public Set<String> getSaveFormFieldNames(Form form)

Description copied from interface: BinderCtrl

Returns all field names for saving with the given Form.

Specified by:

getSaveFormFieldNames in interface BinderCtrl

initQueue

public void initQueue()

Internal use only. Check and init queue

initActivator

public void initActivator()

Internal use only. Check and init Activator