Struct Responder

pub struct Responder<'i, Rq, Rp> { /* private fields */ }

Responder end of a channel

For a static Channel or Interchange, the responder uses a 'static lifetime parameter

Implementations

impl<'i, Rq, Rp> Responder<'i, Rq, Rp>

pub fn channel(&self) -> &'i Channel<Rq, Rp>

pub fn state(&self) -> State

Current state of the channel.

Informational only!

The responder may change this state between calls, internally atomics ensure correctness.

pub fn with_request<R>(&self, f: impl FnOnce(&Rq) -> R) -> Result<R, Error>

If there is a request waiting, perform an operation with a reference to it

This may be called only once as it move the state to BuildingResponse. If you need copies, use take_request

pub fn request(&self) -> Result<&Rq, Error>

If there is a request waiting, obtain a reference to it

This may be called multiple times.

pub fn take_request(&mut self) -> Option<Rq>

If there is a request waiting, take a reference to it out

This may be called only once as it move the state to BuildingResponse. If you need copies, clone the request.

pub fn is_canceled(&self) -> bool

pub fn acknowledge_cancel(&self) -> Result<(), Error>

pub fn respond(&mut self, response: Rp) -> Result<(), Error>

Respond to a request.

If efficiency is a concern, or responses need multiple steps to construct, use with_response_mut or response_mut and send_response.

impl<Rq, Rp> Responder<'_, Rq, Rp>

where Rp: Default,

pub fn with_response_mut<R>( &mut self, f: impl FnOnce(&mut Rp) -> R, ) -> Result<R, Error>

Initialize a response with its default values and mutates it with f

This is usefull to build large structures in-place

pub fn response_mut(&mut self) -> Result<&mut Rp, Error>

Initialize a response with its default values and and return a mutable reference to it

This is usefull to build large structures in-place

pub fn send_response(&mut self) -> Result<(), Error>

Send a response that was already placed in the channel using response_mut or with_response_mut.

Trait Implementations

impl<Rq, Rp> Drop for Responder<'_, Rq, Rp>

fn drop(&mut self)

Executes the destructor for this type.