org.zkoss.zkplus.embed
Class Bridge

java.lang.Object
  extended by org.zkoss.zkplus.embed.Bridge

public class Bridge
extends java.lang.Object

Utilities to allow developers to start an execution in foreign Ajax channel.

Bridge bridge = Bridge.start(svlctx, request, response, desktop);
try {
    //execution is activated and you could access anything belonging to the desktop
    String jscode = bridge.getResult();
    //send jscode back to the client to update DOM, if any
} finally {
    bridge.close(); //stop the execution
}

See also Start Execution in Foreign Ajax Channel

Since:
5.0.5
Author:
tomyeh

Constructor Summary
protected Bridge(javax.servlet.ServletContext svlctx, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Desktop desktop, java.lang.Object locale)
          Constructor.
 
Method Summary
 void close()
          Closes the execution such that other requests targeting the same desktop can be processed.
static Desktop getDesktop(javax.servlet.ServletContext svlctx, javax.servlet.http.HttpServletRequest request, java.lang.String dtid)
          Returns the desktop of the given desktop ID, or null if not found.
 Execution getExecution()
          Returns the execution.
 java.lang.String getResult()
          Returns the result in the JavaScript.
static Bridge start(javax.servlet.ServletContext svlctx, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Desktop desktop)
          Starts an execution.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Bridge

protected Bridge(javax.servlet.ServletContext svlctx,
                 javax.servlet.http.HttpServletRequest request,
                 javax.servlet.http.HttpServletResponse response,
                 Desktop desktop,
                 java.lang.Object locale)
          throws java.lang.Exception
Constructor. Don't invoke this directly. Rather, use start(javax.servlet.ServletContext, javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse, org.zkoss.zk.ui.Desktop) instead.

Throws:
java.lang.Exception
Method Detail

start

public static Bridge start(javax.servlet.ServletContext svlctx,
                           javax.servlet.http.HttpServletRequest request,
                           javax.servlet.http.HttpServletResponse response,
                           Desktop desktop)
Starts an execution. After returned, the execution is activated and the caller is free to access any components belonging the given desktop.

After processing, the caller shall invoke close() to stop the execution (in the finally clause).

Parameters:
desktop - the desktop you want to access. You could retrieve by use of getDesktop(javax.servlet.ServletContext, javax.servlet.http.HttpServletRequest, java.lang.String).

getDesktop

public static Desktop getDesktop(javax.servlet.ServletContext svlctx,
                                 javax.servlet.http.HttpServletRequest request,
                                 java.lang.String dtid)
Returns the desktop of the given desktop ID, or null if not found.

Parameters:
dtid - the desktop's ID.

getExecution

public Execution getExecution()
Returns the execution.


getResult

public java.lang.String getResult()
Returns the result in the JavaScript. The caller shall send it back and evaluate it at the client (eval(jscode);).

After calling this method, the caller shall not modify the component's state any more.


close

public void close()
Closes the execution such that other requests targeting the same desktop can be processed. It must be called. Otherwise, the whole desktop might not be able to be accessed any more.



Copyright © 2005-2011 Potix Corporation. All Rights Reserved. SourceForge.net Logo