Use Piggyback"

From Documentation
Line 3: Line 3:
 
Sometimes it is not hurry to update the result to a client. Rather, the UI update could be sent back when the user, say, clicks a button or trigger some request to the server. This technique is called ''piggyback''.
 
Sometimes it is not hurry to update the result to a client. Rather, the UI update could be sent back when the user, say, clicks a button or trigger some request to the server. This technique is called ''piggyback''.
  
To piggyback, all you need to do is to register an event listener for the <tt>onPiggyback</tt> event to one of the root components. Then, the listener will be invoked each time ZK Update Engine has processed an AU request.
+
In piggyback, all you need to do is to register an event listener for the <tt>onPiggyback</tt> event to one of the root components. Then, the listener will be invoked each time ZK Update Engine has processed an AU request.
  
 
For example, suppose we have a long operation which is processed in a working thread, then:
 
For example, suppose we have a long operation which is processed in a working thread, then:

Revision as of 08:45, 25 July 2011

Sometimes it is not hurry to update the result to a client. Rather, the UI update could be sent back when the user, say, clicks a button or trigger some request to the server. This technique is called piggyback.

In piggyback, all you need to do is to register an event listener for the onPiggyback event to one of the root components. Then, the listener will be invoked each time ZK Update Engine has processed an AU request.

For example, suppose we have a long operation which is processed in a working thread, then:

<window id="main" title="Working Thread" onPiggyback="checkResult()">
    <zscript>
     List result = Collections.synchronizedList(new LinkedList());
 
     void checkResult() {
         while (!result.isEmpty())
             main.appendChild(result.remove(0));
     }
    </zscript>
    <timer id="timer" />
    <button label="Start Working Thread">
        <attribute name="onClick">
     		timer.start();
     		new test.WorkingThread(desktop, result).start();
        </attribute>
    </button>
</window>

The advantage of the piggyback is no extra traffic between the client and the server. However, the user sees no updates if he doesn't have any activity, such as clicking. Whether it is proper is really up to the application requirements.


Note: A deferrable event won't be sent to the client immediately, so the onPiggyback event is triggered only if a non-deferrable event is fired. For more information, please refer to the Deferrable Event Listeners section.

Version History

Last Update : 2011/07/25


Version Date Content
     



Last Update : 2011/07/25

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