Trait runtime_injector::Request[−][src]

pub trait Request: Sized {
    fn request(injector: &Injector, info: &RequestInfo) -> InjectResult<Self>;
}

Expand description

A request to an injector.

Grouping requests

Requests can be grouped together by using tuples to make multiple requests at once. Since there is a limit of 12 supported parameters/dependencies for factories, tuples can also be used to get around that limitation.

use runtime_injector::{Injector, IntoSingleton, Svc};

struct Bar;
struct Baz;
struct Foo(Svc<Bar>, Svc<Baz>);

impl Foo {
    pub fn new((bar, baz): (Svc<Bar>, Svc<Baz>)) -> Self {
        Foo(bar, baz)
    }
}

let mut builder = Injector::builder();
builder.provide(Foo::new.singleton());

let _injector = builder.build();

Owned service requests

Some services can be provided directly via owned pointers (Box). These services can be requested directly via Box, as a collection via Vec<Box>, or lazily via an iterator via Services.

use runtime_injector::{define_module, Injector, IntoTransient, Svc};

#[derive(Default)]
struct Foo;
struct Bar(Box<Foo>);

let module = define_module! {
    services = [
        Foo::default.transient(),
        Bar.transient(),
    ]
};

let mut builder = Injector::builder();
builder.add_module(module);

let injector = builder.build();
let _bar: Box<Bar> = injector.get().unwrap();

Required methods

`fn request(injector: &Injector, info: &RequestInfo) -> InjectResult<Self>`[src]

Expand description

Performs the request to the injector.

Loading content...

Implementations on Foreign Types

`impl<I: ?Sized + Interface> Request for Box`[src]

Requests an owned pointer to a service or interface. Not all providers can provide owned pointers to their service, so this may fail where Svc<T> requests would otherwise succeed.

`fn request(injector: &Injector, info: &RequestInfo) -> InjectResult<Self>`[src]

`impl<I: ?Sized + Interface> Request for Vec<Svc>`[src]

Requests all the implementations of an interface. For sized types, this will return at most one implementation. If no provider is registered for the given interface, then this will return an empty Vec<T>.

`fn request(injector: &Injector, info: &RequestInfo) -> InjectResult<Self>`[src]

`impl<I: ?Sized + Interface> Request for Vec<Box>`[src]

Requests all the implementations of an interface as owned service pointers. If no provider is registered for the given interface, then this will return an empty Vec<T>. If any provider cannot provide an owned service pointer, then an error is returned instead.

`fn request(injector: &Injector, info: &RequestInfo) -> InjectResult<Self>`[src]

`impl<I: ?Sized + Interface> Request for Option<Svc>`[src]

Tries to request a service pointer for a service or interface. If no provider has been registered for it, then returns None. This fails if there are multiple implementations of the given interface.

`fn request(injector: &Injector, info: &RequestInfo) -> InjectResult<Self>`[src]

`impl<I: ?Sized + Interface> Request for Option<Box>`[src]

Tries to request an ownedservice pointer for a service or interface. If no provider has been registered for it, then returns None. This fails if there are multiple implementations of the given interface or if the service cannot be provided via an owned service pointer.