next-service

Dependency injection using JavasScript decorators. Built on top of bottlejs

Usage

Define a service:

import { service } from 'next-service'

@service('myService')
class MyService {
  saveTheWorld() {}
}

Consume a service using inject...

import { inject } from 'next-service'

// using inject without parameter (the field name is used to)
class MyClass {
  @inject
  myService

  doIt() {
    this.myService.saveTheWorld()
  }
}

// or

// using inject with a service name parameter
class MyClass {
  @inject('myService')
  savior

  doIt() {
    this.savior.saveTheWorld()
  }
}

// or

// using inject with a service class parameter
import {MyService} from './MyService.js'

class MyClass {
  @inject(MyService)
  savior

  doIt() {
    this.savior.saveTheWorld()
  }
}

... or as a dependency of another service:

import { service } from 'next-service'

// use the service name as dependency

@service('consumerService', ['myService'])
class ConsumerService {
  constructor(myService) {
    this.myService = myService
  }

  doIt() {
    this.myService.saveTheWorld()
  }
}

// or 
// use the service class as dependency
import { MyService } from './MyService.js'

@service('consumerService', [MyService])
class ConsumerService {
  constructor(myService) {
    this.myService = myService
  }

  doIt() {
    this.myService.saveTheWorld()
  }
}

Bottlejs API

Its possible to use the Bottlejs API

A Bottle instance called registry and its container are exported:

import { registry, container } from 'next-service'

// register a service manually:
registry.service('myService', MyService)

// retrieve a service manually
const myService = container.myService

// add a default decorator
registry.decorator(function(service) {
  // do something with all services
  doSomething(service)
  return service
})

Its possible to define Bottlejs decorator and factory functions as static class functions:

import { service } from 'next-service'

@service('myService')
class MyService {
  static decorator(instance) {
    instance.initialize()
    return instance
  }

  saveTheWorld() {}
}

@service('otherService')
class OtherService {
  static factory(container) {
    const myService = container.myService
    myService.prepareForOtherService()
    return new OtherService(myService)
  }

  constructor(myService) {
    this.myService = myService
  }
}

License

MIT Copyright © 2020 Luiz Américo