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

constructor(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.

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.

getAllIdentifiers

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

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

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

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.

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.