@electron-tools/ioc

Introduction

A simple DI implement of IOC using typescript. inspired by vscode IOC implement.

Installation

# install by npm
$npm install @electron-toolkit/ioc
# install by pnpm
$pnpm add @electron-toolkit/ioc
# install by yarn
$yarn add @electron-toolkit/ioc

Usage

1. enable experimentalDecorators option in your tsconfig.json.

2. register your service by service decorator exported from this package.

// src/serviceA.ts
import { service } from '@electron-toolkit/ioc';

@service('serviceA') // register ServiceA with unique id 'serviceA' using service decorator exported by this package.
class ServiceA {
  // ....
}

1. use inject decorator inject your service to another service.

// src/serviceB.ts
import { service, inject } from '@electron-toolkit/ioc';

@service('serviceB') // also register ServiceB with unique id 'serviceB'
class ServiceB {
  constructor(
    @inject('serviceA') // inject serviceA to serviceB, the only args passed to inject is the service unique id.
    readonly serviceA: ServiceA,
  )
}

1. import all your services and crate a IOC instance in your entry file.

// src/index.ts
import IOC from '@electron-toolkit/ioc';
import './serviceA.ts';
import './serviceB.ts';

const ioc = new IOC();
const serviceA = ioc.getService('serviceA');
const serviceB = ioc.getService('serviceB');
console.log(serviceA instanceof ServiceA); // true
console.log(serviceB instanceof ServiceA); // true
console.log(serviceA === serviceB.a); // true

Features

1. Instance all service in one place.
   by default. service only be instanced when needed. in the case above. if you only call ioc.getService('serviceA'), serviceB will not be instance, cause serviceB is not dependencied by any service, but if you only call ioc.getService('serviceB'), serviceA will be instance, and inject into serviceB. this maybe not what you want. you can init all services in one place by call ioc.init().

const ioc = new IOC();
ioc.init(); // this statement will instance all services registered.

1. Cycle reference. if there are some cycle reference between your services. such as serviceA dependencied by serviceB, serviceB also dependencied by serviceA, you can resolve this issue by get service later instead of constructor of service.

// src/serviceA.ts
import IOC, { service, inject } from '@electron-toolkit/ioc';

@service('serviceA') // register ServiceA with unique id 'serviceA' using service decorator exported by ioc.
class ServiceA {
  constructor(
    @inject('instantiationService') readonly ioc: IOC, // ioc itself is also a service can be injected.
  )

  someMethod() {
    // dynamic get serviceB by ioc#getService API. then you can do anything what serviceB can do.
    const serviceB = this.ioc.getService('serviceB');
    serviceB.xxx;
  }
}