Struct Container 

pub struct Container { /* private fields */ }

The main service container

Stores type-erased bindings keyed by TypeId. Supports both concrete types and trait objects (via Arc<dyn Trait>).

Implementations

impl Container

pub fn new() -> Self

Create a new empty container

pub fn singleton<T: Any + Send + Sync + 'static>(&mut self, instance: T)

Register a singleton instance (shared across all resolutions)

Example

container.singleton(DatabaseConnection::new(&url));

pub fn factory<T, F>(&mut self, factory: F)

where T: Any + Send + Sync + 'static, F: Fn() -> T + Send + Sync + 'static,

Register a factory closure (new instance per resolution)

Example

container.factory(|| RequestLogger::new());

pub fn bind<T: ?Sized + Send + Sync + 'static>(&mut self, instance: Arc<T>)

Bind a trait object to a concrete implementation (as singleton)

This stores the value under TypeId::of::<Arc<dyn Trait>>() which allows trait objects to be resolved via make::<dyn Trait>().

Example

container.bind::<dyn HttpClient>(RealHttpClient::new());

pub fn bind_factory<T: ?Sized + Send + Sync + 'static, F>(&mut self, factory: F)

where F: Fn() -> Arc<T> + Send + Sync + 'static,

Bind a trait object to a factory

Example

container.bind_factory::<dyn HttpClient>(|| Arc::new(RealHttpClient::new()));

pub fn get<T: Any + Send + Sync + Clone + 'static>(&self) -> Option<T>

Resolve a concrete type (requires Clone)

Example

let db: DatabaseConnection = container.get().unwrap();

pub fn make<T: ?Sized + Send + Sync + 'static>(&self) -> Option<Arc<T>>

Resolve a trait binding - returns Arc<T>

Example

let client: Arc<dyn HttpClient> = container.make::<dyn HttpClient>().unwrap();

pub fn has<T: Any + 'static>(&self) -> bool

Check if a concrete type is registered

pub fn has_binding<T: ?Sized + 'static>(&self) -> bool

Check if a trait binding is registered

Trait Implementations

impl Default for Container

fn default() -> Self

Returns the “default value” for a type.