de.ipcon.gui.session

Class Session

java.lang.Object

de.ipcon.gui.session.Session

All Implemented Interfaces:

SessionI, SessionReaderI

public final class Session
extends java.lang.Object
implements SessionI

Concrete implementation of the SessionI contract for client runtime sessions.

Manages authenticated user context, global session variables and in-memory UI state (layout geometry and LRU navigation history via SessionStateXml), bridging runtime state changes to BOs (Sitzung).

See Also:

SessionI, SessionStateXml, Sitzung

Constructor Summary

Constructors

Constructor and Description
Session() Constructs a new uninitialized client session.

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.
java.lang.Object	get(java.lang.String name) Retrieves a session-scoped variable by key.
java.util.Locale	getLocale() Retrieves the current Locale set for the user's session.
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.
Benutzer	getUser() Returns the currently authenticated user.
java.util.Map<java.lang.String,java.lang.Object>	getVariables() Returns an unmodifiable view of all currently registered session variables.
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 class java.lang.Object

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

Constructor Detail

Session

public Session()

Constructs a new uninitialized client session.

Method Detail

getLocale

public java.util.Locale getLocale()

Description copied from interface: SessionReaderI

Retrieves the current Locale set for the user's session.

This locale is critical for correctly formatting numbers, dates, currency, and handling localized text.

Specified by:

getLocale in interface SessionReaderI

Returns:

The user's current Locale.

setUser

public void setUser(Benutzer user)

Description copied from interface: SessionI

Sets or clears the authenticated user BO for this session.

Specified by:

setUser in interface SessionI

Parameters:

user - authenticated Benutzer BO, or null to signify logout

getUser

public Benutzer getUser()

Description copied from interface: SessionReaderI

Returns the currently authenticated user.

Specified by:

getUser in interface SessionReaderI

Returns:

authenticated Benutzer instance, or null

setPersistentSession

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

Description copied from interface: SessionI

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

Specified by:

setPersistentSession in interface SessionI

Parameters:

persistentSession - persistent session BO, or null

getStateXml

public SessionStateXml getStateXml()

Returns the active in-memory UI state helper managing window layout geometry and LRU history. Lazily initializes a fresh instance if needed.

Specified by:

getStateXml in interface SessionI

Returns:

active SessionStateXml instance

setStateXml

public void setStateXml(SessionStateXml stateXml)

Sets the active in-memory UI state helper managing window layout geometry and LRU history to the passed one. Lazily initializes a fresh instance if needed.

Specified by:

setStateXml in interface SessionI

Parameters:

stateXml - the SessionStateXml instance to set

flushPersistentSession

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

Description copied from interface: SessionI

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.

Specified by:

flushPersistentSession in interface SessionI

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

set

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

Description copied from interface: SessionI

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

Specified by:

set in interface SessionI

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

get

public java.lang.Object get(java.lang.String name)

Description copied from interface: SessionReaderI

Retrieves a session-scoped variable by key.

Specified by:

get in interface SessionReaderI

Parameters:

name - variable key identifier

Returns:

associated value object, or null if not found

getVariables

public java.util.Map<java.lang.String,java.lang.Object> getVariables()

Description copied from interface: SessionReaderI

Returns an unmodifiable view of all currently registered session variables.

These variables represent typically machine- or user-profile-specific, application settings.

Specified by:

getVariables in interface SessionReaderI

Returns:

unmodifiable map view of session variables

getReadOnlyInstance

public SessionReaderI getReadOnlyInstance()

Description copied from interface: SessionI

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

Specified by:

getReadOnlyInstance in interface SessionI

Returns:

read-only SessionReaderI delegate view