Asynchronous Tasks"

From Documentation
Line 3: Line 3:
 
If the task of updating UI can be represented as a method, the push can be done easily. All you need to do is
 
If the task of updating UI can be represented as a method, the push can be done easily. All you need to do is
 
#Implement the UI updates in an event listener (implementing <javadoc type="interface">org.zkoss.zk.ui.event.EventListener</javadoc> or <javadoc type="interface">org.zkoss.zk.ui.event.SerializableEventListener</javadoc>).
 
#Implement the UI updates in an event listener (implementing <javadoc type="interface">org.zkoss.zk.ui.event.EventListener</javadoc> or <javadoc type="interface">org.zkoss.zk.ui.event.SerializableEventListener</javadoc>).
#Then, schedule it for executed asynchronously by use of <javadoc method="schedule(org.zkoss.zk.ui.Desktop, org.zkoss.zk.ui.event.EventListener, org.zkoss.zk.ui.event.Event)">org.zkoss.zk.ui.Executions</javadoc>.
+
#Then, schedule it for executed asynchronously by the use of <javadoc method="schedule(org.zkoss.zk.ui.Desktop, org.zkoss.zk.ui.event.EventListener, org.zkoss.zk.ui.event.Event)">org.zkoss.zk.ui.Executions</javadoc>.
  
 
Here is the pseudo code:
 
Here is the pseudo code:

Revision as of 01:36, 26 July 2011


Asynchronous Tasks


If the task of updating UI can be represented as a method, the push can be done easily. All you need to do is

  1. Implement the UI updates in an event listener (implementing EventListener or SerializableEventListener).
  2. Then, schedule it for executed asynchronously by the use of Executions.schedule(Desktop, EventListener, Event).

Here is the pseudo code:

Executions.schedule(desktop,
    new EventListener() {
        public void onEvent(Event event) {
            updateUI(); //whatever you like
        }
    }, event);

You could manipulate UI whatever you want in EventListener.onEvent(Event). It is no different from any other event listener.

Notice that Executions.schedule(Desktop, EventListener, Event) can be called anywhere, including another event listener or a working thread. In other words, you don't have to fork a working thread to use this feature.

Notice that, since there is at most one thread to access the UI of a given desktop, the event listener's performance shall be good. Otherwise, it will block other event listeners from execution. Thus, if you have a long operation to do, you could use event queue's asynchronous event listener, or implement it as a synchronous task and handle lengthy operation outside of the activation block.

Version History

Last Update : 2011/07/26


Version Date Content
5.0.6 November 2010 This feature was introduced. With 5.0.5 or prior, you have to use Event Queues or Synchronous Tasks.



Last Update : 2011/07/26

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.