Struct GenServerHandle 

pub struct GenServerHandle<S: GenServer> { /* private fields */ }

Handle to a running GenServer.

Provides typed call() and cast() methods. The handle owns a sender to the server’s mailbox and a oneshot receiver for join.

Implementations

impl<S: GenServer> GenServerHandle<S>

pub async fn call( &self, cx: &Cx, request: S::Call, ) -> Result<S::Reply, CallError>

Send a call (request-response) to the server.

Blocks until the server replies or the server stops. The reply channel uses obligation-tracked oneshot from channel::session, ensuring that if the server drops the reply without sending, the obligation token panics rather than silently losing the reply.

pub async fn cast(&self, cx: &Cx, msg: S::Cast) -> Result<(), CastError>

Send a cast (fire-and-forget) to the server.

pub fn try_cast(&self, msg: S::Cast) -> Result<(), CastError>

Try to send a cast without blocking.

Applies the server’s CastOverflowPolicy when the mailbox is full:

• Reject: returns CastError::Full
• DropOldest: evicts the oldest message and enqueues the new one

pub async fn info(&self, cx: &Cx, msg: S::Info) -> Result<(), InfoError>

Send an info message (system/out-of-band) to the server.

pub fn try_info(&self, msg: S::Info) -> Result<(), InfoError>

Try to send an info message without blocking.

pub fn cast_overflow_policy(&self) -> CastOverflowPolicy

Returns the server’s overflow policy for cast messages.

pub const fn actor_id(&self) -> ActorId

Returns the server’s actor ID.

pub fn task_id(&self) -> TaskId

Returns the server’s task ID.

pub fn is_finished(&self) -> bool

Returns true if the server has finished.

pub fn stop(&self)

Signals the server to stop gracefully.

pub async fn join(&self, cx: &Cx) -> Result<S, JoinError>

Wait for the server to finish and return its final state.

impl<S: GenServer> GenServerHandle<S>

pub fn server_ref(&self) -> GenServerRef<S>

Returns a lightweight, clonable reference for casting.

Trait Implementations

impl<S: Debug + GenServer> Debug for GenServerHandle<S>

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

Formats the value using the given formatter.