Struct Calls 

pub struct Calls(/* private fields */);

The set of calls a dispatcher routes to: a cheap, cloneable handle to its routing table.

Needed because the dispatcher’s loop and the code that places outbound calls are not the same task. A call made with dial is registered through this from wherever it was dialled; an inbound one needs nothing, because Dispatcher::next reserved its route before the application ever saw the INVITE.

Implementations

impl Calls

pub fn register(&self, dialog: &Dialog) -> Receiver<Incoming>

Route this dialog’s in-dialog requests to the returned inbox.

Hand the inbox to serve. Dropping it — which is what ending a call and returning from serve does — releases the route.

There is a window on the outbound path this cannot close: dial returns only once the 2xx has arrived, so a BYE that overtakes it is answered 481. Closing it needs the Call-ID to be known before the INVITE is sent, which is a change to dial this story does not make.

Registering a dialog that already has a route replaces it, and the previous inbox stops receiving.

pub fn forget(&self, dialog: &Dialog)

Stop routing to this dialog.

Rarely needed — dropping the inbox does the same thing lazily — but explicit when an application tears a call down without dropping the receiver it was serving from.

pub fn len(&self) -> usize

How many calls are currently routed.

pub fn is_empty(&self) -> bool

Whether no call is routed at all.

pub fn counts(&self) -> DispatchCounts

What has been refused, shed or left unplaced.

pub fn responses(&self) -> BTreeMap<u16, u64>

Responses the dispatcher successfully handed to the endpoint, keyed by status code.

Unlike Self::counts, this is wire evidence rather than decision evidence: a response that could not be built or handed off is absent.

Trait Implementations

impl Clone for Calls

fn clone(&self) -> Calls

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Calls

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

Formats the value using the given formatter.