Struct HandlerHandle 

pub struct HandlerHandle { /* private fields */ }

The Handler port role.

A handler that has served nothing is presented every call waiting in the store; once it has served anything, it is presented only the members it served, and another handler’s calls stay waiting for that handler. A claim belongs to the handler it was presented to, so another handler’s settle of it answers SettleError::UnknownClaim.

The empty set meaning no filter is a deliberate deviation from Handler::serve, which says delivery starts at the members listed. The generated dispatch never calls serve (crates/ridl-backend-rust/src/face.rs), so a handler that always filtered would be presented nothing at all by it. serve with an empty slice records nothing and so leaves the handler unfiltered, the same as never having called it. served reads the set back.

Implementations

impl HandlerHandle

pub fn served(&self) -> &[(InterfaceNo, Ordinal)]

The members serve was called with, in the order they were served, with no duplicate.

Trait Implementations

impl Attached for HandlerHandle

fn catalog(&self) -> &CatalogRef

The catalog this port serves.

impl Handler for HandlerHandle

fn serve( &mut self, iface: InterfaceNo, ords: &[Ordinal], ) -> Result<(), ServeError>

Starts presenting calls to the listed members.

fn next_claim(&mut self, out: &mut [u8]) -> Result<Option<Claim>, ReadError>

Copies the next call’s arguments into the front of out. Ok(None) when no call is waiting. ReadError::Short does not consume the call.

fn settle( &mut self, claim: ClaimId, outcome: Result<&[u8], CallError>, ) -> Result<(), SettleError>

Settles a claim with the reply bytes (empty for a command) or the outcome the caller sees. A provider settles CallError::Contract when the arguments break their typl constraints, a require clause fails, or an ensure clause fails, and CallError::Transport(Transport::Corrupt) when the argument bytes fail the structure check.