Struct Router 

pub struct Router { /* private fields */ }

Handler registry + filter pipeline with middleware and nesting.

Implementations

impl Router

pub fn new() -> Self

Create an empty router.

pub fn named(name: &'static str) -> Self

Create an empty router with a diagnostic name.

pub fn name(&self) -> &'static str

The router’s diagnostic name (empty if unnamed).

pub fn use_middleware<F>(&mut self, middleware: F)

where F: for<'a> Fn(&Event, &ExtractBag, Next<'a>) -> HandlerResult + Send + Sync + 'static,

Attach a middleware to this router.

The middleware wraps every route registered on this router and on any router later nested via Router::include. Middleware added on a parent runs outside middleware added on a child; the innermost middleware wraps the handler itself.

pub fn include(&mut self, child: Router)

Nest a child router. The child keeps its own filters and middleware; this router’s middleware wraps around them.

pub fn on_message<F>(&mut self, handler: F)

where F: Fn(&Message) -> HandlerResult + Send + Sync + 'static,

Register a handler for every MESSAGE_CREATE event.

pub fn on_message_filtered<F>( &mut self, handler: F, filters: Vec<MessageFilter>, )

where F: Fn(&Message) -> HandlerResult + Send + Sync + 'static,

Register a MESSAGE_CREATE handler guarded by filters (AND’d).

pub fn add_message_handler(&mut self, definition: MessageHandlerDef)

Register a handler definition produced by #[vaidcord::on_message].

pub fn on_event<F>(&mut self, kind: EventKind, handler: F)

where F: Fn(&Event) -> HandlerResult + Send + Sync + 'static,

Register a handler for an arbitrary event kind.

pub fn on_ready<F>(&mut self, handler: F)

where F: Fn(&Ready) -> HandlerResult + Send + Sync + 'static,

Register a handler for the gateway READY event.

pub fn on_interaction<F>(&mut self, handler: F)

where F: Fn(&Interaction) -> HandlerResult + Send + Sync + 'static,

Register a handler for INTERACTION_CREATE events.

pub fn dispatch_message(&self, message: &Message) -> HandlerResult

Dispatch a message through this router tree (filters + middleware).

Convenience wrapper that builds a one-shot Dispatcher; for the hot path build a Dispatcher once and reuse it so middleware chains stay precomposed.

Trait Implementations

impl Default for Router

fn default() -> Router

Returns the “default value” for a type.