Struct MessageContext 

pub struct MessageContext<T = ()> { /* private fields */ }

Message context for session and metadata management

This structure carries session information and metadata for each message, enabling proper handling of multi-session transports like HTTP.

Examples

use airsprotocols_mcp::protocol::MessageContext;
use chrono::Utc;

// Default generic context (for STDIO)
let context = MessageContext::<()>::new("session-123".to_string())
    .with_remote_addr("192.168.1.100:8080".to_string())
    .with_user_agent("airsprotocols-mcp-client/1.0".to_string());

assert_eq!(context.session_id(), Some("session-123"));
assert_eq!(context.remote_addr(), Some("192.168.1.100:8080"));

Implementations

impl<T> MessageContext<T>

pub fn new_with_transport_data( session_id: impl Into<String>, transport_data: T, ) -> Self

Create a new message context with transport-specific data

pub fn new(session_id: impl Into<String>) -> Self

where T: Default,

Create a new message context without transport data (for simple transports)

pub fn without_session() -> Self

where T: Default,

Create a new message context without session ID or transport data

pub fn session_id(&self) -> Option<&str>

Get session ID

pub fn timestamp(&self) -> DateTime<Utc>

Get message timestamp

pub fn remote_addr(&self) -> Option<&str>

Get remote address

pub fn get_metadata(&self, key: &str) -> Option<&str>

Get metadata value

pub fn with_remote_addr(self, addr: String) -> Self

Set remote address

pub fn with_metadata(self, key: String, value: String) -> Self

Add metadata

pub fn with_user_agent(self, user_agent: String) -> Self

Convenience method to add user agent

pub fn with_content_type(self, content_type: String) -> Self

Convenience method to add content type

pub fn transport_data(&self) -> Option<&T>

Get transport-specific data

Returns a reference to the transport-specific data if it exists. This allows handlers to access transport-specific context information.

pub fn with_transport_data(self, data: T) -> Self

Set transport-specific data

Adds or updates transport-specific data for this context.

pub fn has_transport_data(&self) -> bool

Check if transport data is available

Returns true if this context contains transport-specific data.

Trait Implementations

impl<T: Clone> Clone for MessageContext<T>

fn clone(&self) -> MessageContext<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for MessageContext<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.