de.ipcon.gui.session

Interface SessionI

All Superinterfaces:

SessionReaderI

All Known Implementing Classes:

Session

public interface SessionI
extends SessionReaderI

Mutable client session contract extending SessionReaderI.

Manages active runtime session state including global session variables, authenticated user context, persistent database session records (Sitzung), and in-memory UI layout and LRU history state (SessionStateXml).

See Also:

SessionReaderI, SessionStateXml, Sitzung

Method Summary

Modifier and Type	Method and Description
de.ipcon.db.core.Sitzung	flushPersistentSession(Transaction tx, de.ipcon.swing.WindowState windowState, ClientStateSaveReason reason) Updates window geometry applying reason-based overrides, enforces maximum LRU capacity, and writes the active in-memory SessionStateXml payload into the persistent Sitzung BO within the given transaction.
SessionReaderI	getReadOnlyInstance() Returns a read-only view of this session instance that delegates query calls to this instance while hiding state-mutating operations.
SessionStateXml	getStateXml() Returns the active in-memory UI state helper managing window layout geometry and LRU history.
java.lang.Object	set(java.lang.String name, java.lang.Object value) Sets or updates a session-scoped variable in the synchronized variable map.
void	setPersistentSession(de.ipcon.db.core.Sitzung persistentSession) Binds a persistent session BO (Sitzung) to this runtime session.
void	setStateXml(SessionStateXml stateXml) Sets the active in-memory UI state helper managing window layout geometry and LRU history to the passed one.
void	setUser(Benutzer user) Sets or clears the authenticated user BO for this session.

Methods inherited from interface de.ipcon.gui.session.SessionReaderI

get, getLocale, getUser, getVariables

Method Detail

set

java.lang.Object set(java.lang.String name,
                     java.lang.Object value)

Sets or updates a session-scoped variable in the synchronized variable map.

Parameters:

name - variable key identifier (mandatory)

value - value object to store, or null to clear

Returns:

previously associated value, or null if none was set

setUser

void setUser(Benutzer user)

Sets or clears the authenticated user BO for this session.

Parameters:

user - authenticated Benutzer BO, or null to signify logout

setPersistentSession

void setPersistentSession(de.ipcon.db.core.Sitzung persistentSession)

Binds a persistent session BO (Sitzung) to this runtime session.

Parameters:

persistentSession - persistent session BO, or null

getStateXml

SessionStateXml getStateXml()

Returns the active in-memory UI state helper managing window layout geometry and LRU history.

Returns:

active SessionStateXml instance

setStateXml

void setStateXml(SessionStateXml stateXml)

Sets the active in-memory UI state helper managing window layout geometry and LRU history to the passed one.

Parameters:

stateXml - the SessionStateXml instance to set

flushPersistentSession

de.ipcon.db.core.Sitzung flushPersistentSession(Transaction tx,
                                                de.ipcon.swing.WindowState windowState,
                                                ClientStateSaveReason reason)

Updates window geometry applying reason-based overrides, enforces maximum LRU capacity, and writes the active in-memory SessionStateXml payload into the persistent Sitzung BO within the given transaction.

Parameters:

tx - transaction used for persisting session changes (mandatory)

windowState - current mainframe window geometry and scale state, or null to use fallback defaults

reason - the trigger context defining potential window dimension and state overrides (mandatory)

Returns:

newly instantiated Sitzung instance included in tx, or null if an existing persistent session record was updated

getReadOnlyInstance

SessionReaderI getReadOnlyInstance()

Returns a read-only view of this session instance that delegates query calls to this instance while hiding state-mutating operations.

Returns:

read-only SessionReaderI delegate view