tegral-di-core/guru.zoroark.tegral.di.extensions/EagerImmutableMetaEnvironment

EagerImmutableMetaEnvironment

class EagerImmutableMetaEnvironment(context: EnvironmentContext) : InjectionEnvironment

An injection environment implementation with an eager evaluation strategy.

Note that this environment is only intended for meta-environments. It is not intended for regular-purpose (extensible) environments, which should instead use a MixedImmutableEnvironment.

Characteristics

Eager object creation. Objects are created upon construction of this environment.
Eager object injection. Objects are injected upon calling the injection method.
Idempotent/Immutable. Objects cannot be replaced, injection methods will always return the same thing.

Constructors

EagerImmutableMetaEnvironment

fun EagerImmutableMetaEnvironment(context: EnvironmentContext)

Types

Companion

object Companion : InjectionEnvironmentKind<EagerImmutableMetaEnvironment>

Functions

createInjector

open override fun <T : Any> createInjector(identifier: Identifier<T>, onInjection: (T) -> Unit): Injector<T>

Creates an Injector that can be used as a property delegator, bound against the given identifier.

get

open fun <T : Any> get(identifier: Identifier<T>): T

Gets the component identified by the given identifier. No guarantees are given on this function - it may not be idempotent, depending on the actual implementation.

getAllIdentifiers

open override fun getAllIdentifiers(): Sequence<Identifier<*>>

Returns a sequence of all the known identifiers present in this environment.

getOrNull

open override fun <T : Any> getOrNull(identifier: Identifier<T>): T?

Gets the component identified by the given identifier, or null if no such component exists. No guarantees are given on this function - it may not be idempotent, depending on the actual implementation.

Extensions

get

inline fun <T : Any> InjectionEnvironment.get(qualifier: Qualifier = EmptyQualifier): T

Gets the component identified by the given type turned into an Identifier with an optional qualifier. Throws an exception if no component with this identifier exists.

getFundefOf

fun <R> InjectionEnvironment.getFundefOf(function: KFunction<R>): FundefFunctionWrapper<R>

Retrieve the fundef wrapper for the given function, or throw an exception if no such fundef could be found.

getOrNull

inline fun <T : Any> InjectionEnvironment.getOrNull(qualifier: Qualifier = EmptyQualifier): T?

Gets the component identified by the given type turned into an Identifier with an optional qualifier. Returns null if no component with this identifier exists.