zk开发中关于forward属性的那点事

一，什么是forward

forward属性是zk提供的一个事件转发特性，
该特性将自身的某个原始事件转发到指定的目标组件上
或者将自身的onClick事件转发给另外一个事件

二，forwrd的格式

forward属性可以定义为如下格式

 

1#，forward="target_event_expr"

2#，forward="oringal_event=target_event_expr"

 

1.1-----如果未指定oringal_event原始事件，默认为onClick事件
           所以第1种的完整写法是forward="onClick=target_event_expr"，

1.2-----第二种格式，你可以随意定义原始事件
           例如：<button forward="onMouseOver=onSavePosition"/>
                 <button forward="onBlur=targetId.onClick"/>
          第二种方式是一个通用格式,但大部分情况下我们使用的是onClick事件，
          所以提供了格式1，方便我们的开发

 

1.2.1------target_event_expr是一个表达式，这个表达式也有几种写法：

                1#，event-name

                2#，target-id.event-name

                3#，id1/id2/id3.event-name

                4#，${el-expr}.event-name

 

三，forward的目标是谁？

 在上例子中
 <button forward="onMouseOver=onSavePosition"/>
 onSavePosition是谁的事件呢？
 而<button forward="onSavePosition"/>中onSavePosition事件又是谁的呢？

 

 在这两个例子中，都不属于以下类型，以下三种都指定了目标组件

 

 1#，target-id.event-name

 2#，id1/id2/id3.event-name

 3#，${el-expr}.event-name

 event-name前未指定目标组件，那么zk如何处理？？？

 

 在zk的组件创建阶段，组件创建完毕后，有这么一段代码
 ComponentsCtrl.applyForward(child, childInfo.getForward());（zk5.0.6 UiEngineImpl 743行）
 该代码的作用是应用forward表达式，创建EventListener监听器，由此我们还可以知道forward其实
 与comp.addEventListener差不多的
 然后我们找，找到我们感兴趣的代码，
 然后我找到了AbstractComponent的ForwardEventListener
 的onEvent方法（zk5.0.6 AbstractComponent 2973行）

 

	public void onEvent(Event event) {
	final Object[] info = (Object[])_auxinf.forwards.get(_orgEvent);
	if (info != null)
		for (Iterator it = new ArrayList((List)info[1]).iterator();
		it.hasNext();) {
			final Object[] fwd = (Object[])it.next();
			Component target = resolveForwardTarget(fwd[0]);
			if (target == null) {
				final IdSpace owner = getSpaceOwner();
				if (owner instanceof Component) {
					target = (Component)owner;
				} else {
					//Use the root component instead
					for (target = AbstractComponent.this;;) {
						final Component p = target.getParent();
						if (p == null)
							break;
						target = p;
					}
				}
			}
			//bug #2790393 Forward event listener shall be called immediately
			//(since 3.6.2) change from postEvent to sendEvent to
			//make forward event deterministic
			Events.sendEvent(
				new ForwardEvent((String)fwd[1], target, event, fwd[2]));
		}
	}

 

 

 为了方便理解，我解释一下关键代码的意思，假如转发到的目标target组件为空，首先检测该组件的所属命

名空间是否为一个组件, 如果是一个组件类型，那么设置该命名空间为目标组件，反之将循环迭代获取，直至获取该组件的根组件，即root component

 那么上面我们产生的疑问就豁然开朗了，

 那么实际开发中我们需要注意什么

 

 1，首先在mvc模式开发中，controller（use或apply指定的类）最好建立在forward组件所属的命名空间上

 2，如果没有命名空间，那么将controller（use或apply指定的类）放在root component

 

四，传递参数

 1，forward="target_event_expr"

 2，forward="oringal_event=target_event_expr"

 其中target_event_expr目标事件表达式，有四个类型

 

 1#，event-name

 2#，target-id.event-name

 3#，id1/id2/id3.event-name

 4#，${el-expr}.event-name

 

 这四种类型的event-name也可以使用()号，像方法一样也可以有参数，这个参数可以是el表达式，

 

 a,<button forward="onSomeEvent(${2+2})"/>
 b,<label id="compId"/><button forward="onBlur=onSomeEvent(compId)"/>
 b,<button forward="onBlur=compId.onSomeEvent(&quot;你好我是参数&quot;)"/>

 

 在事件方法中onSomeEvent(Event event){
       event.getData();//返回传递的参数
 }