ZK Developer's Reference/Event Handling/Event Forwarding

Overview

For easy programming, ZK does not introduce any complex event flow. When an event is sent to a target component, only the event listeners registered for the target component will be called. It is the application's job to forward an event to another component if necessary.

For example, you might have a menu item and a button to trigger the same action, say, opening a dialog, and then it is more convenient to have a single listener to open the dialog, and register the listener to the main window rather than register to both the menu item and button. Then, you need only to forward the event from the menu item and button to the main window.

Event Forwarding in Java

Forwarding an event is straightforward: just post or send the event again. However, there is a better way: composer. The composer can be the central place to handle the events. For example,

public class FooComposer extends GenericForwardComposer {
   public void onClick$menuitem() {
     openDialog();
   }
   public void onClick$button() {
     openDialog();
   }
   private void openDialog() {
     //whatever you want
   }
}

Event Forwarding in ZUL

Event forwarding can be done with the forward attribute in ZUL. For example,

<window>
	<button label="Save" forward="onSave"/>
	<button label="Cancel" forward="onCancel"/>
</window>

Then, window will receive the onSave event when the Save button is clicked.

With this approach we could introduce an abstract layer between the event and the component. For example, window needs only to handle the onSave event without knowing which component causes it. Therefore, you could introduce another UI to trigger onSave without modifying the event listener. For example,

	<menuitem label="Save" forward="onSave"/>

Of course, you can use the composer and ZUL's forward together to have more maintainable code.

Notice that the event being forwarded is wrapped as an instance of ForwardEvent. To retrieve the original event, you could invoke ForwardEvent.getOrigin()

Version History

Version	Date	Content