DI

KOtlin DEpendency INjection.

To construct a DI instance, simply use it's block constructor and define your bindings in it :

val di = DI {
    bind<Dice>() with factory { sides: Int -> RandomDice(sides) }
    bind<DataSource>() with singleton { SqliteDS.open("path/to/file") }
    bind<Random>() with provider { SecureRandom() }
    constant("answer") with "forty-two"
}

Types

BindBuilder

interface BindBuilder<C : Any>

Base builder DSL interface that allows to define scoped and context bindings.

Builder

interface Builder : DI.BindBuilder<Any> , DI.BindBuilder.WithScope<Any>

Allows for the DSL inside the block argument of the constructor of DI and DI.Module.

Companion

object Companion

DependencyLoopException

class DependencyLoopException : RuntimeException

Exception thrown when there is a dependency loop.

DIDsl

@DslMarker

annotation class DIDsl

Defines a di DSL function

Key

data class Key<in C : Any, in A, out T : Any>( val contextType: TypeToken<in C>, val argType: TypeToken<in A>, val type: TypeToken<out T>, val tag: Any?)

In DI, each DIBinding is bound to a Key. A Key holds all information necessary to retrieve a factory (and therefore an instance).

MainBuilder

interface MainBuilder : DI.Builder

Builder to create a DI object.

Module

data class Module( val allowSilentOverride: Boolean = false, val prefix: String = "", val init: DI.Builder.() -> Unit)

A module is constructed the same way as in DI is:

NoResultException

class NoResultException(val search: SearchSpecs, message: String) : RuntimeException

Exception thrown when searching for bindings and none could be found.

NotFoundException

class NotFoundException(val key: DI.Key<*, *, *>, message: String) : RuntimeException

Exception thrown when asked for a dependency that cannot be found.

OverridingException

class OverridingException(message: String) : RuntimeException

Exception thrown when there is an overriding error.

Properties

container

abstract val container: DIContainer

Every methods eventually ends up to a call to this container.

open override val di: DI

A DI Aware class must be within reach of a DI object.

diContext

open val diContext: DIContext<*>

A DI Aware class can define a context that is for all retrieval by overriding this property.

diTrigger

open val diTrigger: DITrigger?

Trigger to use that define when the retrieval will be done.

Inheritors

LateInitDI

LazyDI