org.tentackle.persist.rmi

Interface RemoteDbSession

All Superinterfaces:

Remote

All Known Implementing Classes:

RemoteDbSessionImpl

public interface RemoteDbSession
extends Remote

Application server session.
The session will create all other delegates for the client.

Author:

harald

Method Summary

Modifier and Type	Method and Description
void	close() Closes a session.
SessionInfo	getClientSessionInfo() Gets the client user info.
org.tentackle.persist.rmi.DbRemoteDelegate	getDbRemoteDelegate() Gets the delegate for the remote db-connection.
<T extends org.tentackle.persist.rmi.RemoteDelegate> T	getRemoteDelegate(String classname) Gets the delegate for a given classname. Per class the rmi-clients request a remote access there must be a RemoteDelegate.
String	getServerName() Gets the application name of the server.
void	log(Logger.Level level, String message) Sends text based logging infos to the RMI-Server.
void	logStatistics(Logger.Level level, boolean clear) Logs the statistics.

Method Detail

getClientSessionInfo

SessionInfo getClientSessionInfo()
                          throws RemoteException

Gets the client user info.

The server may set certain values in the session info that may be of interest by the client application, for example the userId.

Returns:

the session info

Throws:

RemoteException

getServerName

String getServerName()
              throws RemoteException

Gets the application name of the server.

Returns:

the application name

Throws:

RemoteException

close

void close()
    throws RemoteException

Closes a session.

Throws:

RemoteException

log

void log(Logger.Level level,
         String message)
  throws RemoteException

Sends text based logging infos to the RMI-Server.

Parameters:

level - the logging level

message - the message

Throws:

RemoteException

logStatistics

void logStatistics(Logger.Level level,
                   boolean clear)
            throws RemoteException

Logs the statistics.

Parameters:

level - the logging level

clear - true if clear statistics after dump

Throws:

RemoteException - if logging failed

See Also:

RemoteDelegateInvocationHandler.collectStatistics

getDbRemoteDelegate

org.tentackle.persist.rmi.DbRemoteDelegate getDbRemoteDelegate()
                                                        throws RemoteException

Gets the delegate for the remote db-connection.

Returns:

the delegate

Throws:

RemoteException

getRemoteDelegate

<T extends org.tentackle.persist.rmi.RemoteDelegate> T getRemoteDelegate(String classname)
                                                                  throws RemoteException

Gets the delegate for a given classname.
Per class the rmi-clients request a remote access there must be a RemoteDelegate. The delegate is determined from the classname of the client class as follows:
<package>.rmi.<last-element-of-classname>.class on the client-side and
<package>.rmi.<last-element-of-classname>Impl.class on the server-side.
The delegates are cached on the client side in order to speed up access. Delegates are bound to a session, i.e. there will be one delegate for each session and class.

Parameters:

classname - is the name of class

Returns:

the delegate

Throws:

RemoteException