container-ts

1.0.0-alpha • Public • Published

container-ts

Lightweight decorator-based Dependency Injection container for Typescript and ES7.

Build Status

Features

  • Dependency Injection via ES6 Decorators
  • Container lifecycle management

API

Container {
    add(itemany)void;
    add(itemany, namestring)void;
    get(ctorFunction)any;
    get(namestring)any;
    has(ctorFunction)any;
    has(namestring)any;
    init()void;
    destroy()void;
}
 
class ContainerBuilder {
    static create(): Container;
}
 
// decorators
@Inject(selector: () => any | string)
@Destroy
@PostConstruct

Usage

import {ContainerBuilder, Container, Inject, PostConstruct, Destroy} from './container';
 
@InjectConstructor('ctorDependency1', 'ctorDependency2')
MainClass {
 
    @Inject('elementId')  // injection by id
    dependency1 : DependencyClass1;
 
    @Inject(() => DependencyClass2)  // injection by type
    dependency2 : DependencyClass2;
 
    constructor(a : CtorDependency1, b : CtorDependency2) {
        // ...
    }
 
    @PostConstruct // invoked after all injections have been resolved
    init() {
        console.log(dependency1.sayHello());
    }
 
    @Destroy
    destroy() {
        console.log('destroy');
    }
}
 
let container = ContainerBuilder.create();
 
container.add(new MainClass());
container.add(new DependencyClass1(), 'elementId');
container.add(new DependencyClass2());
 
container.add(new CtorDependency1(), 'ctorDependency1');
container.add(new CtorDependency2(), 'ctorDependency2');
 
container.get('elementId'); // returns the instance of DependencyClass1 added as 'elementId'
 
container.get(DependencyClass2); // returns the DependencyClass2 instance
 
container.init();  // output: "Hello!
 
container.destroy(); // output: "destroy"

Package Sidebar

Install

npm i container-ts

Weekly Downloads

1

Version

1.0.0-alpha

License

MIT

Last publish

Collaborators

  • mserranom