Struct MailboxRouter

pub struct MailboxRouter { /* private fields */ }

MailboxRouter routes messages to the sender that is bound to its nearest prefix.

Implementations

impl MailboxRouter

pub fn new() -> Self

Create a new, empty router.

pub fn downgrade(&self) -> WeakMailboxRouter

Downgrade this router to a WeakMailboxRouter.

pub fn fallback(&self, default: BoxedMailboxSender) -> impl MailboxSender

Returns a new router that will first attempt to find a route for the message in the router’s table; otherwise post the message to the provided fallback sender.

pub fn bind(&self, dest: Reference, sender: impl MailboxSender + 'static)

Bind the provided sender to the given reference. The destination is treated as a prefix to which messages can be routed, and messages are routed to their longest matching prefix.

Trait Implementations

impl Clone for MailboxRouter

fn clone(&self) -> MailboxRouter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MailboxRouter

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

Formats the value using the given formatter.

impl MailboxSender for MailboxRouter

fn post( &self, envelope: MessageEnvelope, return_handle: PortHandle<Undeliverable<MessageEnvelope>>, )

TODO: consider making this publicly inaccessible. While the trait itself needs to be public, its only purpose for the end-user API is to provide the typed messaging APIs from (Once)PortRef and ActorRef.