javax.rad.server
Class AbstractObjectProvider

java.lang.Object
  javax.rad.server.AbstractObjectProvider

Direct Known Subclasses:

DefaultObjectProvider

public abstract class AbstractObjectProvider
extends java.lang.Object

An AbstractObjectProvider handles the access to the life-cycle objects for all sessions. A life-cycle object holds references to the server-side objects which are available for the client within a specific session.

Constructor Summary

protected

AbstractObjectProvider(IServer pServer) Creates a new instance of AbstractObjectProvider for a specific IServer.

Method Summary

abstract java.lang.Object	getObject(ISession pSession, java.lang.String pObjectName) Returns an object from the life-cycle object container for an ISession.
IServer	getServer() Gets the associated IServer.
abstract java.lang.Object	invoke(ISession pSession, java.lang.String pObjectName, java.lang.String pMethodName, java.lang.Object... pParams) Invokes a method from a specific life-cycle object.
abstract java.lang.Object	putObject(ISession pSession, java.lang.String pObjectName, java.lang.Object pObject) Puts an object to the life-cycle object container for an ISession.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractObjectProvider

protected AbstractObjectProvider(IServer pServer)

Creates a new instance of AbstractObjectProvider for a specific IServer.

Parameters:

pServer - the server

Method Detail

getObject

public abstract java.lang.Object getObject(ISession pSession,
                                           java.lang.String pObjectName)
                                    throws java.lang.Throwable

Returns an object from the life-cycle object container for an ISession.

Parameters:

pSession - the session

pObjectName - the object name (can be an EL)

Returns:

the object for the session or null for the life-cycle object container

Throws:

java.lang.Throwable - if the life-cycle object is not available

putObject

public abstract java.lang.Object putObject(ISession pSession,
                                           java.lang.String pObjectName,
                                           java.lang.Object pObject)
                                    throws java.lang.Throwable

Puts an object to the life-cycle object container for an ISession.

Parameters:

pSession - the session

pObjectName - the object name

pObject - the object or null to remove the object

Returns:

null if there was no object under the specified name, otherwise the previous object for the specified name

Throws:

java.lang.Throwable - if the life-cycle object is not available

invoke

public abstract java.lang.Object invoke(ISession pSession,
                                        java.lang.String pObjectName,
                                        java.lang.String pMethodName,
                                        java.lang.Object... pParams)
                                 throws java.lang.Throwable

Invokes a method from a specific life-cycle object.

Parameters:

pSession - the session

pObjectName - the object name

pMethodName - the method to invoke

pParams - the method parameters

Returns:

the return value of the invoked method

Throws:

java.lang.Throwable - if the life-cycle object is not available or the method was not found

getServer

public IServer getServer()

Gets the associated IServer.

Returns:

the server