Struct Context

pub struct Context<'pcx> { /* private fields */ }

A context in which to store providers for services

Implementations

impl Context<'_>

pub fn new() -> Self

Create an empty context

pub fn scoped(&self) -> Context<'_>

Create a sub-context

The retuned context will contain the same elements as the parent context and any elements added to the sub context will not be visible on the original. However, the underlying providers that were added before this call are shared between the two contexts.

pub fn bind_with<'cx, S: Service>( &'cx mut self, provider: impl Provider<'cx, S>, )

Register a new provider for the service S

Panics

If the service binding fails. See try_bind_with for a fallible version of this function.

pub fn bind_fn<'cx, S: Service>( &'cx mut self, provider_fn: impl Fn(&'cx Context<'_>, S::Argument<'_>) -> S::Output<'cx> + Send + Sync + 'cx, )

Register a function as a provider for the service S

Panics

If the service binding fails. See try_bind_fn for a fallible version of this function.

pub fn bind<'cx, S, P>(&'cx mut self)

where S: Service, P: Provider<'cx, S> + Default,

Bind the provider P to the service S

Panics

If the service binding fails. See try_bind for a fallible version of this function.

pub fn unbind<S>(&mut self)

where S: Service,

Delete the provider bound to the service S

Panics

If the service unbinding fails. See try_unbind for a fallible version of this function.

pub fn resolve<S>(&self) -> S::Output<'_>

where S: Service, S::Argument<'static>: Default,

Resolve the service S using the default service argument.

Panics

If no provider is registered for this service. See try_resolve for a fallible version of this function.

pub fn resolve_with<S>(&self, arg: S::Argument<'_>) -> S::Output<'_>

where S: Service,

Resolve the service S given the service argument.

Panics

If no provider is registered for this service. See try_resolve for a fallible version of this function.

pub fn try_bind_with<'cx, S: Service>( &'cx mut self, provider: impl Provider<'cx, S>, ) -> Result<(), BindError>

Try to register a new provider for the service S

Fails

This function will fail if a provider is already bound to the service.

See bind_with for the panicking version of this function.

pub fn try_bind_fn<'cx, S: Service>( &'cx mut self, provider_fn: impl Fn(&'cx Context<'_>, S::Argument<'_>) -> S::Output<'cx> + Send + Sync + 'cx, ) -> Result<(), BindError>

Try to register a function as a provider for the service S

Fails

This function will fail if a provider is already bound to the service.

See bind_fn for the panicking version of this function.

pub fn try_bind<'cx, S, P>(&'cx mut self) -> Result<(), BindError>

where S: Service, P: Provider<'cx, S> + Default,

Try to bind the provider P to the service S

Fails

This function will fail if a provider is already bound to the service.

See bind for the panicking version of this function.

pub fn try_unbind<S>(&mut self) -> Result<(), UnbindError>

where S: Service,

Try to delete the provider bound to the service S.

Fails

This function will fail if no provider is bound to the service.

See unbind for the panicking version of this function.

pub fn try_resolve<S>(&self) -> Option<S::Output<'_>>

where S: Service, S::Argument<'static>: Default,

Try to resolve the service S using the default service argument.

Fails

This function will fail if no provider is bound to the service.

See resolve for the panicking version of this function.

pub fn try_resolve_with<S>(&self, arg: S::Argument<'_>) -> Option<S::Output<'_>>

where S: Service,

Try to resolve the service S given the service argument.

Fails

This function will fail if no provider is bound to the service.

See resolve_with for the panicking version of this function.

Trait Implementations

impl Default for Context<'_>

fn default() -> Self

Returns the “default value” for a type.

impl Send for Context<'_>

impl Sync for Context<'_>