http/session

Documentation

• source: http/session.ts

Overview

Classes

Session

isValid()

Checks if a session is currently valid and active for the request context.

static isValid(): boolean;

Returns

• Type: boolean
• Description: True if the session is valid, false otherwise (e.g., if it has been invalidated or timed out).

getAttribute()

Retrieves the value of a named attribute stored in the session. Note: The underlying Java facade typically stores strings, but the value may represent

• serialized data that should be parsed if complex.

static getAttribute(name: string): string;

Parameter	Type	Description
name	string	The name of the attribute.

Returns

• Type: string
• Description: The attribute value as a string, or null/undefined if not found.

getAttributeNames()

Retrieves an array of all attribute names currently stored in the session. The names are retrieved as a JSON string from the facade and then parsed.

static getAttributeNames(): void;

Returns

• Type: void
• Description: An array of attribute names (strings), or an empty array if no attributes are present.

getCreationTime()

Returns the time at which this session was created, converted to a JavaScript Date object.

static getCreationTime(): Date;

Returns

• Type: Date
• Description: A Date object representing the session's creation time.

getId()

Returns the unique identifier assigned to this session.

static getId(): string;

Returns

• Type: string
• Description: The session ID string.

getLastAccessedTime()

Returns the last time the client accessed this session, converted to a JavaScript Date object. Access includes requests that retrieve or set session attributes.

static getLastAccessedTime(): Date;

Returns

• Type: Date
• Description: A Date object representing the last access time.

getMaxInactiveInterval()

Returns the maximum time interval, in seconds, that the server should keep this session open between client requests. After this interval, the session will be invalidated.

static getMaxInactiveInterval(): number;

Returns

• Type: number
• Description: The maximum inactive interval in seconds.

invalidate()

Invalidates this session, unbinding any objects bound to it. After this call, the session is no longer valid.

static invalidate(): void;

Returns

• Type: void
• Description:

isNew()

Checks if the client does not yet know about the session, typically meaning the server has not yet returned the session ID via a cookie or encoded URL.

static isNew(): boolean;

Returns

• Type: boolean
• Description: True if the session is new (not yet used in a response), false otherwise.

setAttribute()

Binds an object to this session, using the specified name. This is the primary way to store data in the user's session.

static setAttribute(name: string, value: any): void;

Parameter	Type	Description
name	string	The name to bind the object under.
value	any	The value/object to store in the session.

Returns

• Type: void
• Description:

removeAttribute()

Removes the attribute with the given name from the session.

static removeAttribute(name: string): void;

Parameter	Type	Description
name	string	The name of the attribute to remove.

Returns

• Type: void
• Description:

setMaxInactiveInterval()

Specifies the maximum time interval, in seconds, that the server should keep this session open between client requests before automatically invalidating it.

static setMaxInactiveInterval(interval: number): void;

Parameter	Type	Description
interval	number	The new interval in seconds.

Returns

• Type: void
• Description: