@injectable
Make sure to first read the introduction to dependency injection and the
@injectdocumentation.
Apply this to a class to register it for injection.
@injectable (no parameter)
Makes the decorated class injectable as itself or for any of its super-classes (except Object). Each injection will create a new instance.
import {injectable, inject, create, resolve} from 'tabris-decorators';
class Foo {}
@injectable
class Bar extends Foo {} // could also have injection dependencies itself
Instances of an injectable class may then be be obtained via @inject:
// ...
class MyClient {
constructor(
@inject a: Bar; // This will be an instance of Bar
@inject b: Bar; // This will another instance of Bar
@inject c: Foo; // This will also be an instance of Bar since Foo is not injectable
) {
// ...
}
}
Or by explicitly calling resolve():
// ...
const a = resolve(Bar);
const b = resolve(Bar);
const c = resolve(Foo);
If you want to share a single instance for all injections, use @injectable({shared: true}) or @shared instead.
@injectable(config)
Where config is of the type
{
shared?: boolean,
implements?: Class,
param?: InjectionParameter,
priority?: number
}
Like @injectable, but with more options.
-
If
sharedistrue, all injections of the class will use the same instance. This makes the class effectively a singleton. However, if the instance is a widget and is disposed a new one will be created for the next injection. -
implementsallows the decorated class to be injected as an instance of the given class if they have a compatible interface. -
If
paramis set the decorated class will only be injected for injections that have the same injection parameter. The parameter may be given via@inject(param)orresolve(type, param). This is may be useful if multiple compatible types are made injectable. -
The
prioritycontrols the priority of this class over other compatible injectable classes. The class with the highest priority will be used for injection. This value defaults to zero. If there are multiple classes registered with the same priority, the last class that was registered is used to resolve the injection.
