glogic.jthin.serv
Class SessionServiceImp

java.lang.Object
  HessianServlet
      glogic.jthin.serv.SessionServiceImp

All Implemented Interfaces:

SessionServiceIF

public class SessionServiceImp

extends HessianServlet

implements SessionServiceIF

Service implementation that manages user sessions and authentication.

Author:

Sam Taha

See Also:

Serialized Form

Constructor Summary

SessionServiceImp()
Constructor for the SessionServiceImp object

Method Summary

ClientSession	attachToSsoSession(ClientContext context)
ClientSession	createSession(Muffin muffin, ClientContext context) Will create a new session for client.
java.lang.String	decryptSsoSession(java.lang.String stEncryptedSessionID, java.lang.String stSessionHash, long lSessionHashTime)
void	endSession()
EnvStatusInfo	getSystemStatus(ClientContext context) Give info on weather the site is up and if not a brief downtime message.
void	init() Description of the Method
static EnvStatusInfo	internalGetEnvStatusInfo(ClientContext context) This guy only throws a limited set of the WServiceAccessException codes.
void	keepAlive() Client will use this call to keep the client alive in between calls.

Methods inherited from class java.lang.Object

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

Constructor Detail

SessionServiceImp

public SessionServiceImp()

Constructor for the SessionServiceImp object

Method Detail

init

public void init()
          throws ServletException

Description of the Method

Throws:

ServletException - Description of the Exception

createSession

public ClientSession createSession(Muffin muffin,
                                   ClientContext context)
                            throws AuthenticationException,
                                   WServiceAccessException

Will create a new session for client. A user can create multiple sessions for a given username. There is however a limit on the number of sessions to avoid malicious use of the system by a single user. It is up to the client framework to manage mulitple signon sessions on the same client application. The session will timeout if left idle. A timeout preference can be set in the clientcontext, but the server has the right to refuse this and will issue the actual timout window in the WSSession object. If product requires authentication the credentials must be passed into the Muffin and verified.

Specified by:

createSession in interface SessionServiceIF

Parameters:

muffin - Description of the Parameter

context - Description of the Parameter

Returns:

If successful, a ClientSession object is created containing a 40 char session id string.

Throws:

AuthenticationException - details login problem

WServiceAccessException - Description of the Exception

endSession

public void endSession()
                throws WServiceAccessException

Specified by:

endSession in interface SessionServiceIF

Throws:

WServiceAccessException - Description of the Exception

keepAlive

public void keepAlive()
               throws WServiceAccessException

Client will use this call to keep the client alive in between calls.

Specified by:

keepAlive in interface SessionServiceIF

Throws:

WServiceAccessException - Description of the Exception

getSystemStatus

public EnvStatusInfo getSystemStatus(ClientContext context)
                              throws WServiceAccessException

Give info on weather the site is up and if not a brief downtime message. No authentication/session is required.

Specified by:

getSystemStatus in interface SessionServiceIF

Parameters:

context - Description of the Parameter

Returns:

The systemStatus value

Throws:

WServiceAccessException - Description of the Exception

internalGetEnvStatusInfo

public static EnvStatusInfo internalGetEnvStatusInfo(ClientContext context)
                                              throws WServiceAccessException

This guy only throws a limited set of the WServiceAccessException codes. Just upgrade codes will get thrown.

Parameters:

context - Description of the Parameter

Returns:

Description of the Return Value

Throws:

WServiceAccessException - Description of the Exception

decryptSsoSession

public java.lang.String decryptSsoSession(java.lang.String stEncryptedSessionID,
                                          java.lang.String stSessionHash,
                                          long lSessionHashTime)
                                   throws AuthenticationException,
                                          WServiceAccessException

Specified by:

decryptSsoSession in interface SessionServiceIF

Throws:

AuthenticationException

WServiceAccessException

attachToSsoSession

public ClientSession attachToSsoSession(ClientContext context)
                                 throws AuthenticationException,
                                        WServiceAccessException

Specified by:

attachToSsoSession in interface SessionServiceIF

Throws:

AuthenticationException

WServiceAccessException