Struct DiContainerBuilder 

pub struct DiContainerBuilder { /* private fields */ }

Mutable builder used only during boot.

Implementations

impl DiContainerBuilder

pub fn new() -> Self

pub fn register<T: Send + Sync + 'static>(&mut self, v: T) -> &mut Self

Register a fully-constructed singleton. Useful for primitives and configuration values that aren’t #[Injectable].

If an #[Injectable] provider for the same type also exists, freeze panics — a silent winner would mask which instance the app runs with. Use register_override to intentionally replace a descriptor-built provider.

pub fn register_override<T: Send + Sync + 'static>(&mut self, v: T) -> &mut Self

Register a singleton that replaces any #[Injectable] provider of the same type. The descriptor is discarded; everything that depends on T resolves to this instance. Intended for plugins swapping a core service (e.g. a custom SessionStore) — explicit, not accidental.

pub fn add_provider(&mut self, d: &'static ProviderDescriptor) -> &mut Self

Register a provider descriptor (emitted by #[Injectable]).

pub fn freeze(self) -> Arc<FrozenDiContainer>

Run topological sort, detect cycles, build providers in dependency order, then hand back a shared Arc<FrozenDiContainer>.

The container is reference-counted rather than Box::leak-ed: it lives exactly as long as the running server holds a clone (router state, request contexts, gateway runtimes, plugin background tasks) and is dropped when App::launch_on_listener returns — so repeatedly launching in one process (tests) no longer accumulates leaked containers.

Panics if a direct registration collides with an #[Injectable] descriptor without an explicit override — previously the descriptor silently won, which made plugin-side “overrides” no-ops.

Trait Implementations

impl Default for DiContainerBuilder

fn default() -> DiContainerBuilder

Returns the “default value” for a type.