Trait Controller 

pub trait Controller: Sized + 'static {
    type State: Send + Sync + 'static;

    // Required method
    fn mount(
        state: Arc<Self::State>,
    ) -> impl FnOnce(Router<()>) -> Result<Router<()>>;
}

A pure descriptor for a group of HTTP routes sharing a common service dependency.

Do not implement this trait manually. Use the [mount_handlers!] macro, which generates the correct Kleisli arrow from your handler list.

The trait’s only concern is: given Arc<State>, produce a Kleisli arrow that registers this controller’s routes into a Router<()>.

Required Associated Types

type State: Send + Sync + 'static

The service this controller depends on.

The framework wraps it in Arc<State> — Clone is not required on the service itself. Use Atomic* primitives or channels for any state that changes after construction.

Required Methods

fn mount( state: Arc<Self::State>, ) -> impl FnOnce(Router<()>) -> Result<Router<()>>

Returns the Kleisli arrow for this controller.

Signature: Arc<State> -> (Router<()> -> Result<Router<()>>)

Generated by mount_handlers!. The returned closure:

1. Builds a scoped Router<Arc<State>> with this controller’s routes.
2. Provides state via .with_state(state) → Router<()>.
3. Merges into the outer router and returns Ok(merged).

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors