Struct shaku_rocket::Inject

pub struct Inject<'r, M: ModuleInterface + HasComponent<I> + ?Sized, I: Interface + ?Sized>(_, _);

Used to retrieve a reference to a component from a shaku Module. The module should be stored in Rocket's state, in a Box (It could be Box<dyn MyModule> if the module implementation changes at runtime). Use this Inject struct as a request guard.

Example

#![feature(proc_macro_hygiene, decl_macro)]

#[macro_use] extern crate rocket;

use shaku::{module, Component, Interface};
use shaku_rocket::Inject;

trait HelloWorld: Interface {
    fn greet(&self) -> String;
}

#[derive(Component)]
#[shaku(interface = HelloWorld)]
struct HelloWorldImpl;

impl HelloWorld for HelloWorldImpl {
    fn greet(&self) -> String {
        "Hello, world!".to_owned()
    }
}

module! {
    HelloModule {
        components = [HelloWorldImpl],
        providers = []
    }
}

#[get("/")]
fn hello(hello_world: Inject<HelloModule, dyn HelloWorld>) -> String {
    hello_world.greet()
}

fn main() {
    let module = HelloModule::builder().build();

    rocket::ignite()
        .manage(Box::new(module))
        .mount("/", routes![hello])
        .launch();
}

Trait Implementations

impl<'r, M: ModuleInterface + HasComponent<I> + ?Sized, I: Interface + ?Sized> Deref for Inject<'r, M, I>

type Target = I

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'a, 'r, M: ModuleInterface + HasComponent<I> + ?Sized, I: Interface + ?Sized> FromRequest<'a, 'r> for Inject<'r, M, I>

type Error = String

The associated error to be returned if derivation fails.

fn from_request(request: &'a Request<'r>) -> Outcome<Self, Self::Error>

Derives an instance of Self from the incoming request metadata.