Struct FerroLocator 

pub struct FerroLocator { /* private fields */ }

A scoped service registry.

Services are keyed by the TypeId of the service type, which can be a concrete type (Foo, fetched as Rc<Foo>) or a trait object type (dyn IFoo, fetched as Rc<dyn IFoo>):

FerroLocator::current_mutable().bind::<dyn IFoo>().to_constant(Rc::new(Foo::new()));
let foo: Option<Rc<dyn IFoo>> = FerroLocator::current().get_service::<dyn IFoo>();

Like the rest of the object model the locator is per-thread: the current locator and its registrations are only visible on the thread that made them.

Implementations

impl FerroLocator

pub fn current() -> Rc<dyn IFerroDependencyResolver>

The resolver services are looked up in.

pub fn set_current(value: Rc<dyn IFerroDependencyResolver>)

pub fn current_mutable() -> Rc<FerroLocator>

The locator services are registered in.

pub fn set_current_mutable(value: Rc<FerroLocator>)

pub fn new() -> Self

pub fn with_parent_scope(parent_scope: Rc<dyn IFerroDependencyResolver>) -> Self

Creates a locator that falls back to parent_scope for services it has no registration for.

pub fn bind<T: ?Sized + 'static>(&self) -> RegistrationHelper<'_, T>

Starts the registration of the service type T, which may be a trait object type.

pub fn bind_to_self<T: 'static>(&self, constant: Rc<T>) -> &FerroLocator

Registers constant as the service of its own type.

pub fn bind_to_self_singleton<T: Default + 'static>(&self) -> &FerroLocator

Registers a lazily created instance of T as the service of its own type.

pub fn enter_scope() -> Rc<dyn IDisposable>

Makes a new locator, whose parent is the current resolver, the current one. Disposing the returned value restores the previous resolver and locator.

Trait Implementations

impl Default for FerroLocator

fn default() -> Self

Returns the “default value” for a type.

impl IFerroDependencyResolver for FerroLocator

fn get_service_untyped(&self, service_type: TypeId) -> Option<ServiceHandle>

Returns the service registered for service_type, as a handle whose content is Rc<TService>. Use LocatorExtensions::get_service for the typed form.