** (Service) - The registry of IoC services; this is the main IoC interface.
const mixin Registry {
** Invoke to execute all listeners in (or contributions to) the `RegistryStartup` service.
abstract This startup()
** Shuts down the Registry. Notifies all listeners that the registry has shutdown. Further
** method invocations on the Registry are no longer allowed, and the Registry instance
** should be discarded.
**
** See `RegistryShutdown` service for details on how to add shutdown listeners.
abstract This shutdown()
** Obtains a service via its unique service id.
abstract Obj? serviceById(Str serviceId, Bool checked := true)
// The search takes into account inheritance of the service mixin, not the service *implementation*.
** Locates a dependency of the given type.
abstract Obj? dependencyByType(Type dependencyType, Bool checked := true)
** Autobuilds an instance of the given type, resolving all dependencies:
** - create instance via ctor marked with '@Inject' or the best fitting ctor with the *most* parameters
** - inject dependencies into fields (of all visibilities) marked with '@Inject'
** - call any methods annotated with '@PostInjection'
**
** 'ctorArgs' (if provided) will be passed as arguments to the first parameters in the autobuild ctor.
** Handy when you wish the ctor to take a mixture of plain objects and services. e.g. for a `fwt::Command`:
**
** pre>
** syntax: fantom
** registry.autobuild(MySaveCommand#, [entityToSave])
** ...
** class MySaveCommand {
** @Inject
** private EntityDao entityDao
**
** private Entity entity
**
** new make(Entity entity, OtherService service, |This| injectInto) {
** injectInto(this) // ioc to inject all fields
** service.doSomething // this service is only used here, so doesn't need to be a field
** entityDao.save(entity) // use the field service and passed in entity
** }
** }
** <pre
**
** Note: the passed in parameters **must** be first in the ctor parameter list.
**
** 'fieldVals' set (and potentially overwrite) the value of any const fields set by an it-block function.
abstract Obj autobuild(Type type, Obj?[]? ctorArgs := null, [Field:Obj?]? fieldVals := null)
// do we, or do we not pass in ctor args!? ServiceDef says no, as they've been fixed in the ModuleDefs,
// but practical usage say, yes! That's why we're autobuilding!
// Workaround is for the service to expose it's config, and we inject *that* service into an autobuilt class!
// abstract Obj? autobuildService(Str serviceId, Obj?[]? ctorArgs := null, Bool checked := true)
** A companion method to 'autobuild'. Creates an instance of the given mixin, which creates the real instance
** whenever a mixin method is invoked.
**
** If 'implType' is null then it is assumed to have the same name as the mixin, plus a 'Impl' suffix.
**
** @since 1.5.0
abstract Obj createProxy(Type mixinType, Type? implType := null, Obj?[]? ctorArgs := null, [Field:Obj?]? fieldVals := null)
** Injects services and dependencies into fields (of all visibilities) marked with '@Inject'.
**
** Returns the object passed in for method chaining.
**
** *Note: use 'autobuild()' if your fields are const / not-nullable. *
abstract Obj injectIntoFields(Obj instance)
** Calls the method, dependency injecting the parameters. 'instance' can be 'null' if calling a static method.
**
** The optional 'providedMethodArgs' are used as method arguments. Any args not provided are dependency injected;
** unless they have a default argument, in which case nothing is passed in and the default is used.
**
** @since 1.5.0
abstract Obj? callMethod(Method method, Obj? instance, Obj?[]? providedMethodArgs := null)
** Returns a map of all service definitions (keyed by service id) held by this IoC.
** Useful for the inquisitive.
**
** @since 2.0.0
abstract Str:ServiceDefinition serviceDefinitions()
}
