Struct Session 

pub struct Session<S: SessionState> {
    pub session_id: String,
    /* private fields */
}

Session wrapper with typestate for compile-time state checking.

The type parameter S represents the current session state, and the value of that state is stored: see the module documentation.

Fields

session_id: String

Session identifier.

Implementations

impl<S: SessionState> Session<S>

pub fn session_id(&self) -> &str

Returns the session identifier.

pub const fn state(&self) -> &S

Returns the current state and its data.

impl Session<Disconnected>

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

Creates a new disconnected session.

Arguments

• session_id - Unique identifier for this session

pub fn connect(self) -> Session<Connecting>

Transitions to the Connecting state (initiator side).

pub fn accept(self) -> Session<Connecting>

Transitions to the Connecting state after accepting an inbound TCP connection (acceptor side).

impl Session<Connecting>

pub fn send_logon(self) -> Session<LogonSent>

Transitions to the LogonSent state after sending Logon (initiator side), recording the send instant for the logon timeout.

pub fn on_logon_received(self) -> Session<LogonReceived>

Transitions to the LogonReceived state when a Logon arrives from the counterparty (acceptor side), recording the arrival instant.

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

Transitions back to Disconnected on connection failure.

impl Session<LogonSent>

pub const fn sent_at(&self) -> Instant

Returns when the Logon was sent, for the logon_timeout.

pub fn on_logon_ack(self) -> Session<Active>

Transitions to Active state on successful Logon acknowledgement.

pub fn on_logon_reject(self) -> Session<Disconnected>

Transitions to Disconnected on Logon rejection or timeout.

impl Session<LogonReceived>

pub const fn received_at(&self) -> Instant

Returns when the counterparty’s Logon arrived, for the authentication deadline.

pub fn accept_logon(self) -> Session<Active>

Transitions to Active after successful authentication, once the Logon acknowledgement has been sent back to the counterparty.

pub fn reject_logon(self) -> Session<Disconnected>

Transitions to Disconnected when authentication fails and the Logon is rejected (Logout/Reject sent, connection dropped).

pub fn on_timeout(self) -> Session<Disconnected>

Transitions to Disconnected when authentication does not complete within the allowed time.

impl Session<Active>

pub fn start_resend(self, begin_seq: u64, end_seq: u64) -> Session<Resending>

Transitions to Resending state when a gap is detected, carrying the range the resend covers.

Arguments

• begin_seq - BeginSeqNo (7) of the gap
• end_seq - EndSeqNo (16) of the gap; 0 means “through the last message sent”, the FIX convention

pub fn initiate_logout(self) -> Session<LogoutPending>

Transitions to LogoutPending state, recording the send instant for the logout timeout.

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

Transitions to Disconnected on unexpected disconnect.

impl Session<Resending>

pub const fn begin_seq(&self) -> u64

Returns BeginSeqNo (7) of the range being resent.

pub const fn end_seq(&self) -> u64

Returns EndSeqNo (16) of the range being resent; 0 means “through the last message sent”.

pub fn resend_complete(self) -> Session<Active>

Transitions back to Active when resend is complete.

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

Transitions to Disconnected on error.

impl Session<LogoutPending>

pub const fn sent_at(&self) -> Instant

Returns when the Logout was sent, for the logout_timeout.

pub fn on_logout_ack(self) -> Session<Disconnected>

Transitions to Disconnected on Logout acknowledgement or timeout.

pub fn on_timeout(self) -> Session<Disconnected>

Transitions to Disconnected on timeout.

Trait Implementations

impl<S: Debug + SessionState> Debug for Session<S>

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

Formats the value using the given formatter.