Struct Container 

pub struct Container { /* private fields */ }

A registry of services keyed by their Rust type.

Cheap to share: put it in an Arc and clone the handle. All methods take &self — bindings are registered through interior mutability, because service providers register into a container that is already shared.

Implementations

impl Container

pub fn new() -> Container

An empty container.

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

where T: Send + Sync + 'static, F: Fn(&Container) -> Result<T, Error> + Send + Sync + 'static,

Bind a factory that runs on every resolution.

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

where T: Send + Sync + 'static, F: Fn(&Container) -> Result<T, Error> + Send + Sync + 'static,

Bind a factory that runs once; every resolution afterwards hands back the same Arc.

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

where T: Send + Sync + 'static, F: Fn(&Container) -> Result<T, Error> + Send + Sync + 'static,

Like singleton, but flush_scoped drops the memoised instance so the next resolution rebuilds it.

This is the binding a long-running worker wants for per-job state: the queue worker flushes scoped bindings between jobs so one job cannot leak state into the next.

pub fn instance<T>(&self, value: T)

where T: Send + Sync + 'static,

Register an already-built value. The container never constructs it.

pub fn instance_arc<T>(&self, value: Arc<T>)

where T: Send + Sync + 'static,

Register an already-built value that is already behind an Arc — useful when the caller must keep a handle to it too.

pub fn resolve<T>(&self) -> Result<Arc<T>, Error>

where T: Send + Sync + 'static,

Resolve T, building it if necessary.

Fails when T was never bound, when its factory fails, or when resolving it re-enters itself (a dependency cycle).

pub fn try_resolve<T>(&self) -> Option<Arc<T>>

where T: Send + Sync + 'static,

Resolve T, or None if it is unbound or its factory failed.

pub fn expect_resolve<T>(&self) -> Arc<T>

where T: Send + Sync + 'static,

Resolve T, panicking with the resolution error if it is not available. For bootstrap code and facades, where an unbound service is a configuration bug rather than a runtime condition.

pub fn bound<T>(&self) -> bool

where T: 'static,

Whether anything is bound for T.

pub fn forget<T>(&self)

where T: 'static,

Drop the binding for T, if any.

pub fn flush_scoped(&self)

Drop the memoised instance of every scoped binding. The bindings survive; only the built values are discarded.

pub fn len(&self) -> usize

How many types are bound.

pub fn is_empty(&self) -> bool

Whether nothing is bound.

Trait Implementations

impl Debug for Container

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for Container

fn default() -> Container

Returns the “default value” for a type.