Interface McpSessionContext

@ThreadSafe
public interface McpSessionContext

Immutable key/value bag associated with an MCP session.

Author:

Mark Allen

Method Summary

Modifier and Type	Method	Description
@NonNull Map<@NonNull String, @NonNull Object>	asMap()	Provides an immutable snapshot of all stored session values.
@NonNull Boolean	contains(@NonNull String key)	Checks whether a session value is present for the given key.
static @NonNull McpSessionContext	fromBlankSlate()	Creates an empty session context.
static @NonNull McpSessionContext	fromValues(@NonNull Map<@NonNull String, @NonNull Object> values)	Creates a session context from the provided values.
@NonNull Optional<Object>	get(@NonNull String key)	Retrieves a stored session value without type conversion.
<T> @NonNull Optional<T>	get(@NonNull String key, @NonNull Class<T> type)	Retrieves a stored session value with an assignability check.
@NonNull McpSessionContext	with(@NonNull String key, @NonNull Object value)	Returns a new session context containing the given key/value pair.
@NonNull McpSessionContext	without(@NonNull String key)	Returns a new session context without the given key.

Method Details

get

@NonNull Optional<Object> get(@NonNull String key)

Retrieves a stored session value without type conversion.

Parameters:

key - the session key

Returns:

the stored value, if present

get

<T> @NonNull Optional<T> get(@NonNull String key,
 @NonNull Class<T> type)

Retrieves a stored session value with an assignability check.

Type Parameters:

T - the desired type

Parameters:

key - the session key

type - the desired type

Returns:

the stored value cast to type, if present

Throws:

IllegalArgumentException - if the stored value exists but is not assignable to type

contains

@NonNull Boolean contains(@NonNull String key)

Checks whether a session value is present for the given key.

Parameters:

key - the session key

Returns:

true if the key is present

with

@NonNull McpSessionContext with(@NonNull String key,
 @NonNull Object value)

Returns a new session context containing the given key/value pair.

Parameters:

key - the session key

value - the session value

Returns:

a new session context including the provided value

without

@NonNull McpSessionContext without(@NonNull String key)

Returns a new session context without the given key.

Parameters:

key - the session key to remove

Returns:

a new session context without the key, or this instance if the key was absent

asMap

@NonNull Map<@NonNull String, @NonNull Object> asMap()

Provides an immutable snapshot of all stored session values.

Returns:

an immutable map view of the stored session values

fromBlankSlate

static @NonNull McpSessionContext fromBlankSlate()

Creates an empty session context.

Returns:

a blank session context

fromValues

static @NonNull McpSessionContext fromValues(@NonNull Map<@NonNull String, @NonNull Object> values)

Creates a session context from the provided values.

Parameters:

values - the values to seed into the new session context

Returns:

a new immutable session context containing values