com.sibvisions.rad.server.object
Class ExchangeSession

java.lang.Object
  com.sibvisions.rad.server.object.ExchangeSession

public class ExchangeSession
extends java.lang.Object

The ExchangeSession is a session bound connection. It can be used to direct call methods and actions from the bound server-side session.
The ExchangeSession can be used for accessing the session from outside the server, e.g. a servlet. Example for servlet usage: server-side action:

 public void Object generateKey()
 {
   return ObjectCache.put(new ExchangeSession());
 }
 

servlet code:

 public void doGet(HttpServletRequest pRequest, HttpServletResponse pResponse) throws ServletException
 {
   ObjectCache.get(pRequest.getParameter("KEY"));
 }
 

Constructor Summary

ExchangeSession()
Creates a new instance of ExchangeSession.

Method Summary

java.lang.Object	call(java.lang.String pObjectName, java.lang.String pMethod) The method will call a method from the bound session.
java.lang.Object	call(java.lang.String pObjectName, java.lang.String pMethod, java.lang.Object... pParams) The method will call a method from the bound session.
java.lang.Object	callAction(java.lang.String pAction) The method will call an action from the bound session.
java.lang.Object	callAction(java.lang.String pAction, java.lang.Object... pParams) The method will call an action from the bound session.
java.lang.Object	getProperty(java.lang.String pName) Gets the value of a session property.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ExchangeSession

public ExchangeSession()

Creates a new instance of ExchangeSession. The instance will be bound to a server-side session. All method and action calls will be made through the bound session.

Method Detail

call

public java.lang.Object call(java.lang.String pObjectName,
                             java.lang.String pMethod,
                             java.lang.Object... pParams)
                      throws java.lang.Throwable

The method will call a method from the bound session.

Parameters:

pObjectName - an already mapped server object name/alias

pMethod - method name which should be called

pParams - parameters for the method call

Returns:

result from the remote method call

Throws:

java.lang.Throwable - communication error, security checks, invalid method, ...

call

public java.lang.Object call(java.lang.String pObjectName,
                             java.lang.String pMethod)
                      throws java.lang.Throwable

The method will call a method from the bound session.

Parameters:

pObjectName - an already mapped server object name/alias

pMethod - method name which should be called

Returns:

result from the remote method call

Throws:

java.lang.Throwable - communication error, security checks, invalid method, ...

callAction

public java.lang.Object callAction(java.lang.String pAction)
                            throws java.lang.Throwable

The method will call an action from the bound session.

Parameters:

pAction - action which should be called

Returns:

result from the remote action call

Throws:

java.lang.Throwable - communication error, security checks, invalid action, ...

callAction

public java.lang.Object callAction(java.lang.String pAction,
                                   java.lang.Object... pParams)
                            throws java.lang.Throwable

The method will call an action from the bound session.

Parameters:

pAction - action which should be called

pParams - parameters for the action call

Returns:

result from the remote action call

Throws:

java.lang.Throwable - communication error, security checks, invalid method, ...

getProperty

public java.lang.Object getProperty(java.lang.String pName)
                             throws java.lang.Throwable

Gets the value of a session property.

Parameters:

pName - the property name

Returns:

the value of the property or null if the property is not available

Throws:

java.lang.Throwable - communication error, security checks, invalid method, ...