com.bankframe.services.sessionmgmt
Interface SessionManagement

All Superinterfaces:

javax.ejb.EJBObject, ESessionRemote, java.rmi.Remote

All Known Subinterfaces:

EJBSessionManagement, LDAPSessionManagement

public interface SessionManagement

extends ESessionRemote

Remote Interface common to all SessionManagement beans

Author:

ETU

Field Summary

static java.lang.String

SESSION_ID

Method Summary

int	getNumValidSessions() Get the number of valid sessions
BankFrameSession	getSession(java.lang.String sessionId) Return a reference to the specified session
java.util.Enumeration	getSessions() Get all current valid sessions
boolean	isValidSession(java.lang.String sessionId) Checks if the specified session is valid.
void	logoff(java.lang.String sessionId) Delete a BankFrame session
java.lang.String	logon(java.lang.String userId, java.util.Vector authResponse) Create a session using the information provided in the DataPacket
int	removeAllSessions() Remove all Sessions, effectively logging off all users on the system
int	removeInvalidSessions() Remove all Invalid Sessions

Methods inherited from interface com.bankframe.ejb.ESessionRemote

processDataPacket, processDataPackets

Methods inherited from interface javax.ejb.EJBObject

getEJBHome, getHandle, getPrimaryKey, isIdentical, remove

Field Detail

SESSION_ID

public static final java.lang.String SESSION_ID

See Also:

Constant Field Values

Method Detail

getNumValidSessions

public int getNumValidSessions()
                        throws javax.ejb.FinderException,
                               java.rmi.RemoteException

Get the number of valid sessions

Returns:

Number of valid sessions currently logged on

Throws:

javax.ejb.FinderException

java.rmi.RemoteException

getSession

public BankFrameSession getSession(java.lang.String sessionId)
                            throws InvalidSessionException,
                                   java.rmi.RemoteException

Return a reference to the specified session

Parameters:

sessionId - Unique id of the session to be retrieved

Returns:

Reference to the requested session

Throws:

InvalidSessionException

java.rmi.RemoteException

getSessions

public java.util.Enumeration getSessions()
                                  throws javax.ejb.FinderException,
                                         java.rmi.RemoteException

Get all current valid sessions

Returns:

Enumeration containing all valid session instances

Throws:

javax.ejb.FinderException

java.rmi.RemoteException

isValidSession

public boolean isValidSession(java.lang.String sessionId)
                       throws InvalidSessionException,
                              java.rmi.RemoteException

Checks if the specified session is valid. If the session is valid, then its timestamp will also be updated. If the session is not valid then the session will be deleted ( if it has not already been deleted ).

Parameters:

sessionId - Unique id of the session to be checked

Returns:

true if the session is valid, false otherwise

Throws:

InvalidSessionException

java.rmi.RemoteException

logoff

public void logoff(java.lang.String sessionId)
            throws java.rmi.RemoteException

Delete a BankFrame session

Parameters:

sessionId - Unique id of the session to be deleted

Throws:

java.lang.Exception - if the session does not exist

java.rmi.RemoteException

logon

public java.lang.String logon(java.lang.String userId,
                              java.util.Vector authResponse)
                       throws javax.ejb.CreateException,
                              java.rmi.RemoteException

Create a session using the information provided in the DataPacket

Parameters:

authResponse - Response DataPackets from the authentication EJB

Returns:

String containing the sessionId

Throws:

java.lang.Exception - if the session cannot be created

javax.ejb.CreateException

java.rmi.RemoteException

removeAllSessions

public int removeAllSessions()
                      throws javax.ejb.FinderException,
                             java.rmi.RemoteException

Remove all Sessions, effectively logging off all users on the system

Returns:

Number of sessions removed

Throws:

javax.ejb.FinderException

java.rmi.RemoteException

removeInvalidSessions

public int removeInvalidSessions()
                          throws javax.ejb.FinderException,
                                 java.rmi.RemoteException

Remove all Invalid Sessions

Returns:

Number of sessions removed

Throws:

javax.ejb.FinderException

java.rmi.RemoteException