de.ipcon.gui

Class Session

java.lang.Object

de.ipcon.gui.Session

All Implemented Interfaces:

SessionI, SessionReaderI

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

Concrete, final implementation of the SessionI contract. This class manages the current user, locale, and persistent global application variables for the current client session.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	get(java.lang.String name) Retrieves the value of a single global variable by its name.
java.util.Locale	getLocale() Retrieves the current Locale set for the user's session.
SessionReaderI	getReadOnlyInstance() Provides a delegated, read-only view of this mutable session instance.
Benutzer	getUser() Retrieves the instance representing the currently logged-in user for this session.
java.util.Map<java.lang.String,java.lang.Object>	getVariables() Retrieves all currently stored global variables.
java.lang.Object	set(java.lang.String name, java.lang.Object value) Sets or updates the value of a session variable.
void	setUser(Benutzer user) Sets or updates the value of the current user in this session.

Methods inherited from class java.lang.Object

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

Method Detail

getUser

public Benutzer getUser()

Description copied from interface: SessionReaderI

Retrieves the instance representing the currently logged-in user for this session.

Specified by:

getUser in interface SessionReaderI

Returns:

A Benutzer instance representing the current user, or null if the session is not currently authenticated.

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.

getVariables

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

Description copied from interface: SessionReaderI

Retrieves all currently stored global variables.

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

Specified by:

getVariables in interface SessionReaderI

Returns:

A Map<String, Object> containing all variable names (String) and their values (Object). The map returned is typically unmodifiable.

get

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

Description copied from interface: SessionReaderI

Retrieves the value of a single global variable by its name.

Specified by:

get in interface SessionReaderI

Parameters:

name - The name of the global variable to retrieve.

Returns:

The stored value as an Object, or null if the variable does not exist.

set

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

Description copied from interface: SessionI

Sets or updates the value of a session variable.

Specified by:

set in interface SessionI

Parameters:

name - The name of the variable to set.

value - The new value of the variable.

Returns:

The previous value associated with the name, or null if there was no value for that name. (A null return can also indicate that the value previously associated with the name was null.)

setUser

public void setUser(Benutzer user)

Description copied from interface: SessionI

Sets or updates the value of the current user in this session.

This method is typically used to update the authentication state (login/logout).

Specified by:

setUser in interface SessionI

Parameters:

user - The Benutzer instance to set, or null to signify logout/no authenticated user.

getReadOnlyInstance

public SessionReaderI getReadOnlyInstance()

Description copied from interface: SessionI

Provides a delegated, read-only view of this mutable session instance.

This is often used to expose session data to components that should not have write access.

Specified by:

getReadOnlyInstance in interface SessionI

Returns:

A SessionReaderI instance that delegates all read calls to this object, but does not expose any write methods.