ExtensibleInjectionEnvironment

An extensible injection environment is an injection environment that supports extensions.

While some additional features (such as factories) can be implemented purely using Tegral DI's public API, some extensions simply cannot do this and require:

• Analysis of declarations outside of tests.

• State storage when just putting more stuff within the environment is not feasible.

Meta-environments

Extensible environments are, at their core, environments with an additional sub-environment named the "meta environment". By default, meta-environments are EagerImmutableMetaEnvironment objects. This meta environment can be used to:

• Store additional states (via regular put/get/ inject mechanisms).

• Process declarations that were put in the regular environment.

You should not implement this interface directly yourself: subclass DefaultExtensibleInjectionEnvironment instead, which already handles all the extensions-related logic.

Conventions

Extensible injection environments should follow the same conventions as regular injection environments, especially for documentation and usage. However, you must not use InjectionEnvironmentKind for extension environments -- otherwise, the DSL will not see your environment as extensible. Use ExtensibleInjectionEnvironmentKind instead.

In order to uniformly document extensibility, implementors should include the following line in their KDoc comment:

Compatible with installable extensions.

Inheritors