facet classafIoc::Inject

sys::Obj
  afIoc::Inject : sys::Facet

Use in services to inject other services and dependencies.

It is the intention that @Inject be (re)used a general purpose facet for many Dependency Providers, both within and outside the IoC library itself.

With that in mind, support for the facet attributes id, type and optional is entirely dependent on the individual dependency providers.

Within IoC the @Inject facet is used to:

id

Source

const Str? id

Usage within IoC is optional:

Service injection: the (qualified) id of the service to inject (use when the same mixin has multiple implementations)
Log injection: the name of the log to inject
LocalRef injection: the name used to store the local ref.

optional

Source

const Bool optional := false

If true and the dependency / service does not exist then injection should fail silently without causing an Err.

Within IoC optional is only used when injecting services. Useful when injecting services from (optional) 3rd party libraries.

Defaults to false.

type

Source

const Type? type

Usage within IoC is optional: