Struct Router 

pub struct Router { /* private fields */ }

Named command registry with synchronous dispatch.

Implementations

impl Router

pub fn new() -> Self

Create an empty dispatch table.

pub fn register<F>(&self, name: impl Into<String>, handler: F)

where F: Fn(Vec<u8>) -> Vec<u8> + Send + Sync + 'static,

Register a handler for a command name.

If a handler was already registered under name it is replaced.

pub fn register_simple<F>(&self, name: impl Into<String>, handler: F)

where F: Fn() -> Vec<u8> + Send + Sync + 'static,

Register a handler that takes no payload.

The incoming payload bytes are silently discarded.

pub fn call(&self, name: &str, payload: Vec<u8>) -> Result<Vec<u8>, Error>

Dispatch a command by name.

Returns the handler’s response bytes on success, or Error::UnknownCommand if no handler is registered for name.

pub fn call_or_error_bytes(&self, name: &str, payload: Vec<u8>) -> Vec<u8>

Dispatch a command by name, returning raw bytes in all cases.

On success the handler’s response bytes are returned. On failure the error’s Display text is returned as UTF-8 bytes. This is a convenience wrapper for call sites (such as the custom protocol handler) that must always produce a Vec<u8>.

pub fn has(&self, name: &str) -> bool

Check whether a command is registered.

Trait Implementations

impl Debug for Router

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

Formats the value using the given formatter.

impl Default for Router

fn default() -> Self

Returns the “default value” for a type.