public class CometServerPush extends Object implements org.zkoss.zk.ui.sys.ServerPush
org.zkoss.zkmax.ui.comet.CometServerPush
instead.
Available in ZK PE.
Modifier and Type | Class and Description |
---|---|
static interface |
CometServerPush.AsyncInfo
The interface for implementing asynchronous processing.
|
Constructor and Description |
---|
CometServerPush() |
Modifier and Type | Method and Description |
---|---|
boolean |
activate(long timeout) |
boolean |
deactivate(boolean stop) |
org.zkoss.zk.ui.Desktop |
getDesktop()
Returns the desktop that this server push belongs to (never null).
|
protected String |
getStartScript()
Returns the JavaScript codes to enable (a.k.a., start) the server push.
|
protected String |
getStopScript()
Returns the JavaScript codes to disable (a.k.a., stop) the server push.
|
boolean |
isActive() |
void |
onPiggyback() |
protected void |
onStart()
Called when
start(org.zkoss.zk.ui.Desktop) is called. |
protected void |
onStop()
Called when
stop() is called. |
protected void |
processRequest(org.zkoss.zk.ui.Execution exec,
CometServerPush.AsyncInfo ai)
Called when receiving the comet request from the client.
|
void |
resume()
ZK-1777 resume serverpush after DesktopRecycling
|
<T extends org.zkoss.zk.ui.event.Event> |
schedule(org.zkoss.zk.ui.event.EventListener<T> listener,
T event,
org.zkoss.zk.ui.sys.Scheduler<T> scheduler) |
protected boolean |
setBusy()
Sets busy and return if it is busy for processing other request.
|
void |
start(org.zkoss.zk.ui.Desktop desktop)
Starts the server push.
|
protected void |
startClientPush()
Sends an AU response to the client to start the server push.
|
void |
stop()
Stops the server push.
|
protected void |
stopClientPush()
Sends an AU response the client to stop the server push.
|
protected void startClientPush()
start(org.zkoss.zk.ui.Desktop)
.
The derived class usually overrides this method to support different devices.
The default implementation is to send an AuScript
response to contain
the script specified in a preference called CometServerPush.start
,
or the script returned by getStartScript()
, if the preference is not found.
Devices that don't support scripts could override this method
to send a custom AU response (AuResponse
).
protected void stopClientPush()
The derived class usually overrides this method to support different devices, such as ZK Mobile.
The default implementation is to send an AuScript
instance to contain
the script specified in a preference called CometServerPush.stop
,'
or the script returned by getStopScript()
, if the preference is not found.
Devices that don't support scripts could override this method
to send a custom AU response (AuResponse
).
protected String getStartScript()
startClientPush()
to prepare the script
of AuScript
that will be sent to the client.protected String getStopScript()
stopClientPush()
to prepare the script
of AuScript
that will be sent to the client.public org.zkoss.zk.ui.Desktop getDesktop()
public boolean isActive()
isActive
in interface org.zkoss.zk.ui.sys.ServerPush
public void start(org.zkoss.zk.ui.Desktop desktop)
The derived class rarely need to override this method.
Rather, override startClientPush()
.
start
in interface org.zkoss.zk.ui.sys.ServerPush
public void resume()
resume
in interface org.zkoss.zk.ui.sys.ServerPush
public void stop()
The derived class rarely need to override this method.
Rather, override stopClientPush()
.
stop
in interface org.zkoss.zk.ui.sys.ServerPush
protected void onStart()
start(org.zkoss.zk.ui.Desktop)
is called.
This method is called before startClientPush()
, and used to initialize the desktop,
if necessary.
The default implementation initializes an extension to process the comet request.
protected void onStop()
stop()
is called.
This method is called after stopClientPush()
is called and this server push
has been cleaned up.
The default implementation does nothing.
public void onPiggyback()
onPiggyback
in interface org.zkoss.zk.ui.sys.ServerPush
public <T extends org.zkoss.zk.ui.event.Event> void schedule(org.zkoss.zk.ui.event.EventListener<T> listener, T event, org.zkoss.zk.ui.sys.Scheduler<T> scheduler)
schedule
in interface org.zkoss.zk.ui.sys.ServerPush
protected boolean setBusy()
It is possible since the client might abort the previous one and issue a new one but their server didn't know.
protected void processRequest(org.zkoss.zk.ui.Execution exec, CometServerPush.AsyncInfo ai) throws IOException
IOException
public boolean activate(long timeout) throws InterruptedException, org.zkoss.zk.ui.DesktopUnavailableException
activate
in interface org.zkoss.zk.ui.sys.ServerPush
InterruptedException
org.zkoss.zk.ui.DesktopUnavailableException
public boolean deactivate(boolean stop)
deactivate
in interface org.zkoss.zk.ui.sys.ServerPush
Copyright © 2016. All Rights Reserved.