Struct dptree::di::DependencyMap

pub struct DependencyMap { /* private fields */ }

A DI container with multiple dependencies.

This DI container stores types by their corresponding type identifiers. It cannot prove at compile-time that a type of a requested value exists within the container, so if you do not provide necessary types but they were requested, it will panic.

Examples

use dptree::di::{DependencyMap, DependencySupplier};

let mut container = DependencyMap::new();
container.insert(5_i32);
container.insert("abc");

assert_eq!(container.get(), Arc::new(5_i32));
assert_eq!(container.get(), Arc::new("abc"));

// If a type of a value already exists within the container, it will be replaced.
let old_value = container.insert(10_i32).unwrap();

assert_eq!(old_value, Arc::new(5_i32));
assert_eq!(container.get(), Arc::new(10_i32));

When a value is not found within the container, it will panic:

use dptree::di::{DependencyMap, DependencySupplier};
let mut container = DependencyMap::new();
container.insert(10i32);
container.insert(true);
container.insert("static str");

// thread 'main' panicked at 'alloc::string::String was requested, but not provided. Available types:
//    &str
//    bool
//    i32
// ', /media/hirrolot/772CF8924BEBB279/Documents/Rust/dptree/src/di.rs:150:17
// note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
let string: Arc<String> = container.get();

Implementations

impl DependencyMap

pub fn new() -> Self

pub fn insert<T: Send + Sync + 'static>(&mut self, item: T) -> Option<Arc<T>>

Inserts a value into the container.

If the container do not has this type present, None is returned. Otherwise, the value is updated, and the old value is returned.

pub fn insert_container(&mut self, container: Self)

Inserts all dependencies from another container into itself.

pub fn remove<T: Send + Sync + 'static>(&mut self) -> Option<Arc<T>>

Removes a value from the container.

If the container do not has this type present, None is returned. Otherwise, the value is removed and returned.

Trait Implementations

impl Clone for DependencyMap

fn clone(&self) -> DependencyMap

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DependencyMap

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

Formats the value using the given formatter.

impl Default for DependencyMap

fn default() -> DependencyMap

Returns the “default value” for a type.

impl<V> DependencySupplier<V> for DependencyMap where
    V: Send + Sync + 'static, 

fn get(&self) -> Arc<V>

Get the value.

impl<T: Send + Sync + 'static> Insert<T> for DependencyMap

fn insert(&mut self, value: T) -> Option<Arc<T>>

Inserts value into itself, returning the previous value, if exists.

impl PartialEq<DependencyMap> for DependencyMap

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.