Struct runtime_injector::RequestInfo

pub struct RequestInfo { /* fields omitted */ }

Information about an active request.

Implementations

impl RequestInfo

#[must_use]

pub fn new() -> Self

Creates a new, empty instance of RequestInfo.

#[must_use]

pub fn with_request(&self, service: ServiceInfo) -> Self

Creates a new child instance of RequestInfo with the given service appended to the end of the request path.

#[must_use]

pub fn service_path(&self) -> &[ServiceInfo]

Gets the current request path. This can be used to configure a service based on what it’s being injected into.

Example

use runtime_injector::{
    Injector, IntoTransient, RequestInfo, ServiceInfo, Svc,
};

struct Foo(pub Svc<Baz>);
struct Bar(pub Svc<Baz>);
struct Baz(pub i32);

impl Baz {
    pub fn new(request_info: RequestInfo) -> Self {
        let service_path = request_info.service_path();
        let value = match service_path.get(0) {
            Some(root) if root == &ServiceInfo::of::<Foo>() => 1,
            Some(root) if root == &ServiceInfo::of::<Bar>() => 2,
            _ => 0,
        };

        Baz(value)
    }
}

let mut builder = Injector::builder();
builder.provide(Foo.transient());
builder.provide(Bar.transient());
builder.provide(Baz::new.transient());

let injector = builder.build();
let foo: Svc<Foo> = injector.get().unwrap();
let bar: Svc<Bar> = injector.get().unwrap();
let baz: Svc<Baz> = injector.get().unwrap();
assert_eq!(1, foo.0.0);
assert_eq!(2, bar.0.0);
assert_eq!(0, baz.0);

pub fn insert_parameter(
    &mut self,
    key: &str,
    value: impl RequestParameter
) -> Option<Box<dyn RequestParameter>>

Sets the value of a request parameter for the request. If a parameter has already been set to a value, then that value is returned.

pub fn remove_parameter(
    &mut self,
    key: &str
) -> Option<Box<dyn RequestParameter>>

Removes and returns the value of a parameter if it has been set.

#[must_use]

pub fn get_parameter(&self, key: &str) -> Option<&dyn RequestParameter>

Gets the value of a parameter if it has been set.

#[must_use]

pub fn get_parameter_mut(
    &mut self,
    key: &str
) -> Option<&mut dyn RequestParameter>

Mutably gets the value of a parameter if it has been set.

Trait Implementations

impl Clone for RequestInfo

fn clone(&self) -> RequestInfo

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RequestInfo

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

Formats the value using the given formatter.

impl Default for RequestInfo

fn default() -> Self

Returns the “default value” for a type.

impl Request for RequestInfo

Requests the information about the current request.

fn request(_injector: &Injector, info: &RequestInfo) -> InjectResult<Self>

Performs the request to the injector.

impl WithArg for RequestInfo

fn with_arg<S: Service, T: Service + AsAny + Clone>(
    &mut self,
    value: T
) -> Option<Box<dyn RequestParameter>>

Adds an argument for a service. See the docs for Arg<T>.