Struct HandlerRegistry

Source

pub struct HandlerRegistry { /* private fields */ }

Expand description

Registry of event handlers

Implementations§

Source §

impl HandlerRegistry

Source

pub fn new() -> Self

Create a new empty handler registry

Source

pub fn register_simple<F>(&self, name: &str, handler: F)
where F: Fn(&mut dyn Any) + Send + Sync + 'static,

Register a simple handler

Source

pub fn register_with_value<F>(&self, name: &str, handler: F)
where F: Fn(&mut dyn Any, Box<dyn Any>) + Send + Sync + 'static,

Register a handler with a value parameter

Source

pub fn register_with_command<F>(&self, name: &str, handler: F)
where F: Fn(&mut dyn Any) -> Box<dyn Any> + Send + Sync + 'static,

Register a handler that returns a command

Source

pub fn get(&self, name: &str) -> Option<HandlerEntry>

Look up a handler by name

Source

pub fn dispatch( &self, handler_name: &str, model: &mut dyn Any, value: Option<String>, )

Dispatches a handler by name, executing it with the provided model and optional value.

This is a convenience method that combines get() and handler invocation.

§Arguments

handler_name - Name of the handler to dispatch
model - Mutable reference to the model (as &mut dyn Any)
value - Optional string value passed to WithValue handlers

§Example

use dampen_core::HandlerRegistry;

let registry = HandlerRegistry::new();
registry.register_simple("greet", |model| {
    let model = model.downcast_mut::<MyModel>().unwrap();
    model.count += 1;
});

let model = &mut MyModel { count: 0 } as &mut dyn std::any::Any;
registry.dispatch("greet", model, None);

Source

pub fn dispatch_with_command( &self, handler_name: &str, model: &mut dyn Any, value: Option<String>, ) -> Option<Box<dyn Any>>

Dispatches a handler by name and returns any command/task it produces.

This method is similar to dispatch() but returns the command/task from WithCommand handlers instead of discarding it. This is essential for integrating with the Elm/MVU pattern where handlers can return tasks.

§Arguments

handler_name - Name of the handler to dispatch
model - Mutable reference to the model (as &mut dyn Any)
value - Optional string value passed to WithValue handlers

§Returns

Some(Box<dyn Any>) - The command/task from a WithCommand handler
None - For Simple and WithValue handlers, or if handler not found

§Example

use dampen_core::HandlerRegistry;
use iced::Task;

let registry = HandlerRegistry::new();
registry.register_with_command("navigate", |model| {
    let model = model.downcast_mut::<MyModel>().unwrap();
    Box::new(Task::done(Message::SwitchView))
});

let model = &mut MyModel::default() as &mut dyn std::any::Any;
if let Some(boxed_task) = registry.dispatch_with_command("navigate", model, None) {
    if let Ok(task) = boxed_task.downcast::<Task<Message>>() {
        return *task;
    }
}