com.bankframe.services.sessionmgmt
Class SessionManagementBean

java.lang.Object
  com.bankframe.ejb.ESessionBean
      com.bankframe.services.sessionmgmt.SessionManagementBean

All Implemented Interfaces:

javax.ejb.EnterpriseBean, ESession, java.io.Serializable, javax.ejb.SessionBean

Direct Known Subclasses:

EJBSessionManagementBean, LDAPSessionManagementBean

public abstract class SessionManagementBean

extends ESessionBean

Defines the generic interface for BankFrame MCA session management.

Author:

ETU

See Also:

Serialized Form

Constructor Summary

SessionManagementBean()

Method Summary

abstract int	getNumValidSessions() Get the number of valid sessions
BankFrameSession	getSession(java.lang.String sessionId) Get a BankFrameSession instance associate with the specified id.
abstract java.util.Enumeration	getSessions() Get all current valid sessions
boolean	isValidSession(java.lang.String sessionId) Verify if the specified id refers to a valid session.
void	logoff(java.lang.String sessionId) Delete a BankFrame session
java.lang.String	logon(java.lang.String userId, java.util.Vector authResponse) Create a BankFrame session, by authenticating the user information in the data packet
java.util.Vector	processDataPacket(DataPacket data) This method will process a Data Packet.
abstract int	removeAllSessions() Remove all Sessions, effectively logging off all users on the system
abstract int	removeInvalidSessions() Remove all Invalid Sessions

Methods inherited from class com.bankframe.ejb.ESessionBean

audit, ejbActivate, ejbCreate, ejbLoad, ejbPassivate, ejbPostCreate, ejbRemove, ejbStore, getSessionContext, processDataPackets, setSessionContext, unsetSessionContext

Methods inherited from class java.lang.Object

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

Constructor Detail

SessionManagementBean

public SessionManagementBean()

Method Detail

getNumValidSessions

public abstract int getNumValidSessions()
                                 throws javax.ejb.FinderException

Get the number of valid sessions

Returns:

Number of valid sessions currently logged on

Throws:

javax.ejb.FinderException - on error

getSession

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

Get a BankFrameSession instance associate with the specified id. The session's timestamp will be updated each time this method is called successfully.

Parameters:

sessionId - Unique id of the session to retrieve

Returns:

BankFrameSession instance

Throws:

InvalidSessionException - if the session does not exist or has expired

java.rmi.RemoteException

getSessions

public abstract java.util.Enumeration getSessions()
                                           throws javax.ejb.FinderException

Get all current valid sessions

Returns:

Enumeration containing all valid session instances

Throws:

javax.ejb.FinderException - if an error is encountered retrieving session instances

isValidSession

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

Verify if the specified id refers to a valid session. If it does then the sessions timestamp will be updated, otherwise the session will be deleted ( if it has not already been deleted )

Parameters:

sessionId - Id of the session to validate

Returns:

True if the session is valid, false otherwise

Throws:

InvalidSessionException

java.rmi.RemoteException

logoff

public void logoff(java.lang.String sessionId)

Delete a BankFrame session

Parameters:

sessionId - Id of the session to delete

Throws:

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

logon

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

Create a BankFrame session, by authenticating the user information in the data packet

Parameters:

authResponse - Response DataPackets from the authentication EJB

userId - UserId of the user to logon

Returns:

BankFrameSessionId for the authenticated user

Throws:

javax.ejb.CreateException

java.rmi.RemoteException

processDataPacket

public java.util.Vector processDataPacket(DataPacket data)
                                   throws java.rmi.RemoteException,
                                          ProcessingErrorException

This method will process a Data Packet.

Specified by:

processDataPacket in interface ESession

Specified by:

processDataPacket in class ESessionBean

Parameters:

data - The DataPacket to process

Returns:

Vector containing 1 or more response DataPackets

Throws:

ProcessingErrorException

java.rmi.RemoteException

removeAllSessions

public abstract int removeAllSessions()
                               throws javax.ejb.FinderException

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

Returns:

Number of sessions removed

Throws:

javax.ejb.FinderException - if an error occurs

removeInvalidSessions

public abstract int removeInvalidSessions()
                                   throws javax.ejb.FinderException

Remove all Invalid Sessions

Returns:

Number of sessions removed

Throws:

javax.ejb.FinderException - if an error occurs while removing invalid sessions