Creates a new instance of the dependency resolver.
(optional) default configuration where key is dependency name and value is locator (descriptor)
(optional) default component references
Configures the component with specified parameters.
configuration parameters to set.
Finds all matching dependencies by their name.
the dependency name to locate.
true to raise an exception when no dependencies are found.
a list of found dependencies
Gets one optional dependency by its name.
the dependency name to locate.
a dependency reference or null of the dependency was not found
Gets one required dependency by its name. At least one dependency must present. If the dependency was found it throws a ReferenceException
the dependency name to locate.
a dependency reference
Gets all optional dependencies by their name.
the dependency name to locate.
a list with found dependencies or empty list of no dependencies was found.
Gets all required dependencies by their name. At least one dependency must be present. If no dependencies was found it throws a ReferenceException
the dependency name to locate.
a list with found dependencies.
Adds a new dependency into this resolver.
the dependency's name.
the locator to find the dependency by.
Sets the component references. References must match configured dependencies.
references to set.
Creates a new DependencyResolver from a list of key-value pairs called tuples where key is dependency name and value the depedency locator (descriptor).
a list of values where odd elements are dependency name and the following even elements are dependency locator (descriptor)
a newly created DependencyResolver.
Generated using TypeDoc
Helper class for resolving component dependencies.
The resolver is configured to resolve named dependencies by specific locator. During deployment the dependency locator can be changed.
This mechanism can be used to clarify specific dependency among several alternatives. Typically components are configured to retrieve the first dependency that matches logical group, type and version. But if container contains more than one instance and resolution has to be specific about those instances, they can be given a unique name and dependency resolvers can be reconfigured to retrieve dependencies by their name.
Configuration parameters
dependencies:
References
References must match configured dependencies.
Example
class MyComponent: IConfigurable, IReferenceable { private _dependencyResolver: DependencyResolver = new DependencyResolver(); private _persistence: IMyPersistence; ... public constructor() { this._dependencyResolver.put("persistence", new Descriptor("mygroup", "persistence", "*", "*", "1.0")); } public configure(config: ConfigParams): void { this._dependencyResolver.configure(config); } public setReferences(references: IReferences): void { this._dependencyResolver.setReferences(references); this._persistence = this._dependencyResolver.getOneRequired<IMyPersistence>("persistence"); } } // Create mycomponent and set specific dependency out of many let component = new MyComponent(); component.configure(ConfigParams.fromTuples( "dependencies.persistence", "mygroup:persistence:*:persistence2:1.0" // Override default persistence dependency )); component.setReferences(References.fromTuples( new Descriptor("mygroup","persistence","*","persistence1","1.0"), new MyPersistence(), new Descriptor("mygroup","persistence","*","persistence2","1.0"), new MyPersistence() // This dependency shall be set ));IReferences