Container.ts
135 lines
| 4.4 KiB
| video/mp2t
|
TypeScriptLexer
|
|
r49 | import { ActivationContext } from "./ActivationContext"; | ||
| import { ValueDescriptor } from "./ValueDescriptor"; | ||||
| import { ActivationError } from "./ActivationError"; | ||||
|
|
r131 | import { ServiceMap, Descriptor, PartialServiceMap, ContainerProvided, Resolver, ContainerServiceMap, ContainerKeys, ContainerResolve, ILifetimeManager } from "./interfaces"; | ||
|
|
r49 | import { TraceSource } from "../log/TraceSource"; | ||
|
|
r120 | import { Configuration, RegistrationMap } from "./Configuration"; | ||
|
|
r49 | import { Cancellation } from "../Cancellation"; | ||
|
|
r129 | import { MapOf, IDestroyable } from "../interfaces"; | ||
|
|
r118 | import { isDescriptor } from "./traits"; | ||
|
|
r131 | import { LifetimeManager } from "./LifetimeManager"; | ||
| import { each } from "../safe"; | ||||
|
|
r49 | |||
| const trace = TraceSource.get("@implab/core/di/ActivationContext"); | ||||
|
|
r129 | export class Container<S extends object = any> implements Resolver<S>, IDestroyable { | ||
|
|
r120 | readonly _services: ContainerServiceMap<S>; | ||
|
|
r49 | |||
|
|
r114 | readonly _cache: MapOf<any>; | ||
|
|
r131 | readonly _lifetimeManager: ILifetimeManager; | ||
|
|
r114 | readonly _cleanup: (() => void)[]; | ||
|
|
r49 | |||
|
|
r114 | readonly _root: Container<S>; | ||
|
|
r49 | |||
|
|
r114 | readonly _parent?: Container<S>; | ||
|
|
r49 | |||
|
|
r114 | _disposed: boolean; | ||
|
|
r49 | |||
|
|
r114 | constructor(parent?: Container<S>) { | ||
|
|
r49 | this._parent = parent; | ||
| this._services = parent ? Object.create(parent._services) : {}; | ||||
| this._cache = {}; | ||||
| this._cleanup = []; | ||||
| this._root = parent ? parent.getRootContainer() : this; | ||||
|
|
r115 | this._services.container = new ValueDescriptor(this) as any; | ||
|
|
r114 | this._disposed = false; | ||
|
|
r131 | this._lifetimeManager = new LifetimeManager(); | ||
|
|
r49 | } | ||
| getRootContainer() { | ||||
| return this._root; | ||||
| } | ||||
| getParent() { | ||||
| return this._parent; | ||||
| } | ||||
|
|
r131 | getLifetimeManager() { | ||
| return this._lifetimeManager; | ||||
| } | ||||
|
|
r120 | resolve<K extends ContainerKeys<S>>(name: K, def?: ContainerResolve<S, K>): ContainerResolve<S, K> { | ||
|
|
r49 | trace.debug("resolve {0}", name); | ||
| const d = this._services[name]; | ||||
| if (d === undefined) { | ||||
|
|
r114 | if (def !== undefined) | ||
|
|
r49 | return def; | ||
| else | ||||
| throw new Error("Service '" + name + "' isn't found"); | ||||
|
|
r114 | } else { | ||
|
|
r49 | |||
|
|
r131 | const context = new ActivationContext<S>(this, this._services, String(name), d); | ||
|
|
r114 | try { | ||
|
|
r131 | return d.activate(context); | ||
|
|
r114 | } catch (error) { | ||
| throw new ActivationError(name.toString(), context.getStack(), error); | ||||
| } | ||||
|
|
r49 | } | ||
| } | ||||
| /** | ||||
| * @deprecated use resolve() method | ||||
| */ | ||||
|
|
r120 | getService<K extends ContainerKeys<S>>(name: K, def?: ContainerResolve<S, K>) { | ||
|
|
r114 | return this.resolve(name, def); | ||
|
|
r49 | } | ||
|
|
r115 | register<K extends keyof S>(name: K, service: Descriptor<S, S[K]>): this; | ||
| register(services: PartialServiceMap<S>): this; | ||||
| register<K extends keyof S>(nameOrCollection: K | ServiceMap<S>, service?: Descriptor<S, S[K]>) { | ||||
|
|
r49 | if (arguments.length === 1) { | ||
|
|
r114 | const data = nameOrCollection as ServiceMap<S>; | ||
|
|
r115 | |||
|
|
r131 | each(data, (v, k) => this.register(k, v)); | ||
|
|
r49 | } else { | ||
| if (!isDescriptor(service)) | ||||
| throw new Error("The service parameter must be a descriptor"); | ||||
|
|
r115 | this._services[nameOrCollection as K] = service as any; | ||
|
|
r49 | } | ||
| return this; | ||||
| } | ||||
|
|
r114 | onDispose(callback: () => void) { | ||
|
|
r49 | if (!(callback instanceof Function)) | ||
| throw new Error("The callback must be a function"); | ||||
| this._cleanup.push(callback); | ||||
| } | ||||
|
|
r129 | destroy() { | ||
| return this.dispose(); | ||||
| } | ||||
|
|
r49 | dispose() { | ||
|
|
r114 | if (this._disposed) | ||
| return; | ||||
| this._disposed = true; | ||||
| for (const f of this._cleanup) | ||||
| f(); | ||||
|
|
r49 | } | ||
| /** | ||||
| * @param{String|Object} config | ||||
| * The configuration of the contaier. Can be either a string or an object, | ||||
| * if the configuration is an object it's treated as a collection of | ||||
| * services which will be registed in the contaier. | ||||
| * | ||||
| * @param{Function} opts.contextRequire | ||||
| * The function which will be used to load a configuration or types for services. | ||||
| * | ||||
| */ | ||||
|
|
r120 | async configure(config: string | RegistrationMap<S>, opts?: any, ct = Cancellation.none) { | ||
|
|
r115 | const c = new Configuration<S>(this); | ||
|
|
r49 | |||
| if (typeof (config) === "string") { | ||||
|
|
r59 | return c.loadConfiguration(config, opts && opts.contextRequire, ct); | ||
|
|
r49 | } else { | ||
| return c.applyConfiguration(config, opts && opts.contextRequire, ct); | ||||
| } | ||||
| } | ||||
|
|
r120 | createChildContainer<S2 extends object = S>(): Container<S & S2> { | ||
|
|
r114 | return new Container<S & S2>(this as any); | ||
|
|
r49 | } | ||
| } | ||||
