Use Piggyback"

From Documentation
m ((via JWB))
m (replace tt with code (via JWB))
Line 3: Line 3:
 
Sometimes there is no hurry to update the result to a client. Rather, the UI update could be sent back when the user, say, clicks a button or triggers some request to the server. This technique is called ''piggyback''.
 
Sometimes there is no hurry to update the result to a client. Rather, the UI update could be sent back when the user, say, clicks a button or triggers 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 <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 <code>onPiggyback</code> 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:
Line 31: Line 31:
 
<blockquote>
 
<blockquote>
 
----
 
----
'''Note''': A deferrable event won't be sent to the client immediately, so the <tt>onPiggyback</tt> event is triggered only if a non-deferrable event is fired. For more information, please refer to the [[ZK_Developer's_Reference/Event_Handling/Event_Listening#Deferrable_Event_Listeners|Deferrable Event Listeners]] section.
+
'''Note''': A deferrable event won't be sent to the client immediately, so the <code>onPiggyback</code> event is triggered only if a non-deferrable event is fired. For more information, please refer to the [[ZK_Developer's_Reference/Event_Handling/Event_Listening#Deferrable_Event_Listeners|Deferrable Event Listeners]] section.
 
</blockquote>
 
</blockquote>
  

Revision as of 14:16, 12 January 2022

Sometimes there is no hurry to update the result to a client. Rather, the UI update could be sent back when the user, say, clicks a button or triggers 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 : 2022/01/12


Version Date Content
     



Last Update : 2022/01/12

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