de.must.appletserver

Class SessionStd

java.lang.Object

de.must.appletserver.SessionStd

public abstract class SessionStd
extends java.lang.Object

The session, which is assigned to each applet. Open windows, form data are kept here; the applet is a remote mirror of the session.

Field Summary

Fields

Modifier and Type	Field and Description
protected SessionData	sessionData

Constructor Summary

Constructors

Constructor and Description
SessionStd() Constructs a new session.

Method Summary

Modifier and Type	Method and Description
protected void	afterFirstSessionHandle() Called afters session creation and after session' response writer has been established.
protected abstract void	build(SessionData sessionData) Build part to be done by the individual session object.
void	buildAll() Called from MainStd after instantiating the session to build things in arbitrary sequence.
protected void	connectToDb()
protected SessionData	createSessionData() Constructs session data.
void	destroy() Destroy this object in order to free resources and weak references more early than garbage collector.
protected void	free() Frees (releases) references caused by this frame, particularly static register entries.
protected abstract java.lang.String	getApplicationTitle()
java.lang.String	getContextPath() Returns the context path.
protected abstract GlobalStd	getGlobal() Returns the application's global objects class.
java.lang.String	getSessionId() Returns the session's id
protected java.lang.String	getTranslation(java.lang.String resourceKey)
protected void	handlePostOrGetWhatever(GeneralizedRequest request, HttpServletResponse response)
boolean	isOld() Returns true if this session is old.
boolean	isToClose() Returns true if the session is to close.
boolean	open(java.lang.String id, HttpServletResponse response)
boolean	seemsToBeUnused() Returns true if this session seems to be unused.
void	setContextPath(java.lang.String contextPath) Sets the context path.
void	setSecondsForUnusedSessions(int secondsForUnusedSessions) Set the interval to treat a session as unused.
void	setSessionId(java.lang.String sessionId) Sets the session's id
static void	setUseSeperateConnectionsForEachSession(boolean newSeparateConnections) Determines whether each session should use its own database connection or not.
protected boolean	specialHandling(GeneralizedRequest request)

Methods inherited from class java.lang.Object

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

Field Detail

sessionData

protected SessionData sessionData

Constructor Detail

SessionStd

public SessionStd()

Constructs a new session.

Method Detail

setUseSeperateConnectionsForEachSession

public static void setUseSeperateConnectionsForEachSession(boolean newSeparateConnections)

Determines whether each session should use its own database connection or not. Should be set to true, if commit / rollback is to be used. Be advised that this requires DB connection to be passed reliably from each data object to the other.

Parameters:

separateConnections - whether each session should use its own database connection or not

connectToDb

protected void connectToDb()

createSessionData

protected SessionData createSessionData()

Constructs session data. Override to assign session data with additional fields for the specific application.

Returns:

session data

setSecondsForUnusedSessions

public void setSecondsForUnusedSessions(int secondsForUnusedSessions)

Set the interval to treat a session as unused.

Parameters:

secondsForUnusedSessions - the interval to treat a session as unused

getGlobal

protected abstract GlobalStd getGlobal()

Returns the application's global objects class.

setContextPath

public void setContextPath(java.lang.String contextPath)

Sets the context path.

Parameters:

contextPath - the context path

getContextPath

public java.lang.String getContextPath()

Returns the context path.

Returns:

the context path

setSessionId

public void setSessionId(java.lang.String sessionId)

Sets the session's id

Parameters:

sessionId - the session's id

getSessionId

public java.lang.String getSessionId()

Returns the session's id

Returns:

the session's id

buildAll

public void buildAll()

Called from MainStd after instantiating the session to build things in arbitrary sequence.

build

protected abstract void build(SessionData sessionData)

Build part to be done by the individual session object.

Parameters:

sessionData - the session's public data

handlePostOrGetWhatever

protected void handlePostOrGetWhatever(GeneralizedRequest request,
                                       HttpServletResponse response)
                                throws java.io.IOException,
                                       ServletException

Throws:

java.io.IOException

ServletException

open

public boolean open(java.lang.String id,
                    HttpServletResponse response)
             throws java.io.IOException

Throws:

java.io.IOException

afterFirstSessionHandle

protected void afterFirstSessionHandle()

Called afters session creation and after session' response writer has been established.

getApplicationTitle

protected abstract java.lang.String getApplicationTitle()

specialHandling

protected boolean specialHandling(GeneralizedRequest request)

isToClose

public boolean isToClose()

Returns true if the session is to close.

Returns:

true if the session is to close

seemsToBeUnused

public boolean seemsToBeUnused()

Returns true if this session seems to be unused.

Returns:

true if this session seems to be unused

isOld

public boolean isOld()

Returns true if this session is old. Why do we check this? We do not kill a one and only session even if it seems to be unused. But MySQL loves to renew connections once a day. Therefore, an old session might have open tables with connection no longer valid.

Returns:

true if this session is old

destroy

public void destroy()

Destroy this object in order to free resources and weak references more early than garbage collector.

free

protected void free()

Frees (releases) references caused by this frame, particularly static register entries. To be called via destroy() to prevent multiple call. Override it to do additional releases and don't forget to call super.free() at the end.

See Also:

destroy()

getTranslation

protected java.lang.String getTranslation(java.lang.String resourceKey)