Struct Connection 

pub struct Connection<S> { /* private fields */ }

A connection in a specific state.

The type parameter S represents the current state of the connection. Different methods are available depending on the state.

Implementations

impl Connection<Disconnected>

pub fn new() -> Self

Create a new disconnected connection.

pub fn id(&self) -> &str

Get the connection ID.

pub fn connect(self) -> Connection<Connected>

Establish the connection (transition to Connected state).

In a real implementation, this would take a transport and establish the connection. Here we just transition the state.

impl Connection<Connected>

pub fn id(&self) -> &str

Get the connection ID.

pub const fn connected_at(&self) -> Option<Instant>

Get when the connection was established.

pub fn uptime(&self) -> Duration

Get how long the connection has been active.

pub fn initialize( self, client_info: ClientInfo, client_capabilities: ClientCapabilities, ) -> (Connection<Initializing>, InitializeRequest)

Begin initialization (transition to Initializing state).

For clients: Send initialize request with client info and capabilities. For servers: This is called when receiving an initialize request.

pub fn disconnect(self) -> Connection<Disconnected>

Disconnect (transition back to Disconnected state).

impl Connection<Initializing>

pub fn id(&self) -> &str

Get the connection ID.

pub const fn client_info(&self) -> Option<&ClientInfo>

Get the client info.

pub const fn client_capabilities(&self) -> Option<&ClientCapabilities>

Get the client capabilities.

pub fn complete( self, server_info: ServerInfo, server_capabilities: ServerCapabilities, ) -> Connection<Ready>

Complete initialization (transition to Ready state).

This is called after the initialize response is received (client) or sent (server).

pub fn abort(self) -> Connection<Disconnected>

Abort initialization (transition back to Disconnected).

impl Connection<Ready>

pub fn id(&self) -> &str

Get the connection ID.

pub const fn connected_at(&self) -> Option<Instant>

Get when the connection was established.

pub fn uptime(&self) -> Duration

Get how long the connection has been active.

pub const fn last_activity(&self) -> Option<Instant>

Get the last activity timestamp.

pub fn client_info(&self) -> &ClientInfo

Get the client info.

Panics

This should never panic if the connection was properly initialized, as the typestate pattern ensures this is only callable in Ready state. Use try_client_info() for a fallible version.

pub const fn try_client_info(&self) -> Option<&ClientInfo>

Try to get the client info.

Returns None if the client info was not set (should not happen in normal use).

pub fn server_info(&self) -> &ServerInfo

Get the server info.

Panics

This should never panic if the connection was properly initialized, as the typestate pattern ensures this is only callable in Ready state. Use try_server_info() for a fallible version.

pub const fn try_server_info(&self) -> Option<&ServerInfo>

Try to get the server info.

Returns None if the server info was not set (should not happen in normal use).

pub fn client_capabilities(&self) -> &ClientCapabilities

Get the client capabilities.

Panics

This should never panic if the connection was properly initialized, as the typestate pattern ensures this is only callable in Ready state. Use try_client_capabilities() for a fallible version.

pub const fn try_client_capabilities(&self) -> Option<&ClientCapabilities>

Try to get the client capabilities.

Returns None if the client capabilities were not set (should not happen in normal use).

pub fn server_capabilities(&self) -> &ServerCapabilities

Get the server capabilities.

Panics

This should never panic if the connection was properly initialized, as the typestate pattern ensures this is only callable in Ready state. Use try_server_capabilities() for a fallible version.

pub const fn try_server_capabilities(&self) -> Option<&ServerCapabilities>

Try to get the server capabilities.

Returns None if the server capabilities were not set (should not happen in normal use).

pub fn next_request_id(&mut self) -> RequestId

Generate the next request ID.

pub fn touch(&mut self)

Update the last activity timestamp.

pub fn is_idle(&self, timeout: Duration) -> bool

Check if the connection has been idle for longer than the given duration.

pub fn shutdown(self) -> Connection<Closing>

Begin shutdown (transition to Closing state).

impl Connection<Closing>

pub fn id(&self) -> &str

Get the connection ID.

pub fn close(self) -> Connection<Disconnected>

Complete the shutdown (transition to Disconnected state).

Trait Implementations

impl<S: Debug> Debug for Connection<S>

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

Formats the value using the given formatter.

impl Default for Connection<Disconnected>

fn default() -> Self

Returns the “default value” for a type.