org.zkoss.bind
Class AnnotateBinder

java.lang.Object
  org.zkoss.bind.impl.BinderImpl
      org.zkoss.bind.AnnotateBinder

All Implemented Interfaces:

java.io.Serializable, Binder, BinderCtrl

Direct Known Subclasses:

AnnotateBinderEx

public class AnnotateBinder
extends BinderImpl

ZK Annotated Binder, it parse the component annotation and handles the binding of components and view model.

Since:

6.0.0

Author:

henrichen, dennischen

See Also:

Serialized Form

Field Summary

Fields inherited from class org.zkoss.bind.impl.BinderImpl

BINDCTX, BINDER, BINDING, DEPENDS_ON_COMP, IGNORE_REF_VALUE, IGNORE_TRACKER, LOAD_FORM_COMPONENT, LOAD_FORM_EXPRESSION, MODEL, NOTIFYS, ON_BIND_CLEAN, ON_BIND_INIT, RENDERER_INSTALLED, SAVE_BASE, SRCPATH, VALIDATES, VAR, VM

Fields inherited from interface org.zkoss.bind.Binder

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

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

DEFAULT_QUEUE_NAME, DEFAULT_QUEUE_SCOPE, PHASE_LISTENER_CLASS_KEY

Constructor Summary

AnnotateBinder()
new a annotate binder with default event queue name and scope

AnnotateBinder(java.lang.String qname, java.lang.String qscope)
new a binder with event queue name and scope

Method Summary

void	init(Component comp, java.lang.Object vm, java.util.Map<java.lang.String,java.lang.Object> initArgs) Initializes the binder with a root component and viewModel object.
void	initAnnotatedBindings() This method will parse Zul component's annotation that user declared and call Binder's addBindings series methods to initiate binder's internal binding syntax trees, which then will cooperate with context(for look up variables) and be used by Binder's EL engine while BinderImpl.loadComponent(Component, boolean) or Command been triggered.

Methods inherited from class org.zkoss.bind.impl.BinderImpl

addChildrenInitBinding, addChildrenInitBinding, addChildrenLoadBindings, addChildrenLoadBindings, addCommandBinding, addFormAssociatedSaveBinding, addFormInitBinding, addFormLoadBindings, addFormSaveBindings, addGlobalCommandBinding, addPropertyInitBinding, addPropertyLoadBindings, addPropertySaveBindings, addReferenceBinding, checkInit, createParamCall, getBindingAnnotationInfoChecker, getBindingExecutionInfoCollector, getConverter, getEvaluatorX, getEventQueue, getForm, getFormAssociatedSaveBindings, getLoadPromptBindings, getPhaseListener, getRenderer, getTemplateResolver, getTracker, getValidationMessages, getValidator, getView, getViewModel, hasValidator, init, isActivating, loadComponent, newCommandBinding, newInitChildrenBinding, newInitFormBinding, newInitPropertyBinding, newLoadChildrenBinding, newLoadFormBinding, newLoadPropertyBinding, newSaveFormBinding, newSavePropertyBinding, notifyChange, postCommand, removeBindings, removeBindings, removeBindings, sendCommand, setPhaseListener, setTemplate, setValidationMessages, setViewModel, storeForm

Methods inherited from class java.lang.Object

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

Constructor Detail

AnnotateBinder

public AnnotateBinder()

new a annotate binder with default event queue name and scope

AnnotateBinder

public AnnotateBinder(java.lang.String qname,
                      java.lang.String qscope)

new a binder with event queue name and scope

Parameters:

qname - event queue name

qscope - event queue scope, see EventQueues

Method Detail

init

public void init(Component comp,
                 java.lang.Object vm,
                 java.util.Map<java.lang.String,java.lang.Object> initArgs)

Initializes the binder with a root component and viewModel object. You should never call this if you use AnnotateBinder and zk annotation since 6.0.2, this method will take care of super's Binder.init(Component, Object) only
If AnnotateBinder need to be used manually, initAnnotatedBindings() need to be invoked for scanning and building binding syntax tree.

Specified by:

init in interface Binder

Overrides:

init in class BinderImpl

Parameters:

comp - root component of binder

vm - viewModel object

initArgs - args key-value pairs for initial, nullable

See Also:

initAnnotatedBindings()

initAnnotatedBindings

public void initAnnotatedBindings()

This method will parse Zul component's annotation that user declared and call Binder's addBindings series methods to initiate binder's internal binding syntax trees, which then will cooperate with context(for look up variables) and be used by Binder's EL engine while BinderImpl.loadComponent(Component, boolean) or Command been triggered.

Since:

6.0.2