DI Module v2

Dependency Injection Module
The module was inspired by di.js in @angular.

Quick Navigate

1. Decorator
   • Injectable
   • Inject
   • Component
2. Global Variables
   • INJECTABLE_STORE
   • INSTANCE_STORE
   • COMPONENT_STORE
3. Functions
   • boostrap
   • construct
   • instanize
4. Interface
   • componentConfig (reference only)
   • providerConfig (reference only)
5. Examples
6. Lisence

Cookbook

Injectable

Use @Injectable() decorator to register class to INJECTABLE_STORE
Otherwise the class cannot be instanized by function instanize

Inject

Use @Inject(...Providers) decorator to inject providers(functions) to class.
The inputed providers will be used to construct instance of decorated class.
NOTE: the sequence of providers is NOT restricted

Component

Use @Component(config: componentConfig) to decorate class.
pass componentConfig to decorator to determine the specific providers for constructing class instance.

bootstrap()

Example: bootstrap({ provider: [...Function] });
This is where intanizing started.
The instanzing function will generate instaces of inputed Providers and store them to INSTANCE_STORE as global instance.

construct(Component)

The function returns an instance which all dependencies has been injected.

instanize(InjectableClass)

The function returns an instance of registered injectable class.

componentConfig

    {
        restrict?: boolean,
        provider: [Function|providerConfig]
    }

NOTE: In restrict mode, if the dependency instance cannot be found, it will throw an Error. Otherwise it will return null

providerConfig

    {
        provider: Function,
        useValue?: any,
        useClass?: Function,
        useExistInstance?: any
    }

The priority is useClass > useValue > useExistInstance

Examples

The index.web.js has exposed a global variable DI, use