Service

see affiliated serviser-config npm package

ResourceManager is used for any resource that can be inspected for its integrity eg. storage connections, remote dependent API services, config provider etc...

self reference

self reference

serviser npm package version

The main representation of a service as a whole. Holds AppManager, ResourceManager, RemoteServiceManager as well as global service configuration (Config) object. Optionally can hold references to Model managers of various ODMs/ORMs

Parameters:

• config
• Type: Config

• npm serviser-config object

Fires:

• Service#error
• Service#listening
• Service#set-up
• Service#shell-cmd
• Service#static:service
• Service#static:set-up
• Service#static:app
• Service#static:shell-cmd

default app.on('listening') listener

Parameters:

• app
• Type: App

default app.on('post-init') listener

Parameters:

• app
• Type: App

syntax sugar for building an application (defaults to express based App) via AppManager

Parameters:

• name
• Type: String

• application name as defined in apps.<name> of service configuration file (config.js)

• options optional
• Type: Object

• see App constructor options

• Constructor optional
• Type: function
• Default: App

• a constructor which implements AppInterface

calls App#close on each App in the AppManager

returns RemoteServiceManager or constructs one if there isn't any. This requires serviser-sdk npm module to be available

one of the registered apps failed to initialize

all registered apps are successfully initialized and at this point already can receive connections

The event is emitted after service configuration and all registered resources are validated and ready for use.
Listeners are expected to do any initial asynchronous processing if needed and then register Apps with Router & Route definitions.
The listeners are handled asynchronously and so can deal with Promises

//$PROJECT_ROOT/index.js
const Service = require('serviser');
const service = new Service(require('serviser-config'));

service.once('set-up', function() {
    require('./lib/app.js');
});

emitted once prior a shell command dispatching. Allows to register custom user-defined shell commands. See serviser-shell plugin

Properties:

• yargs
• Type: Object

• preconfigured instance of yargs npm package

for serviser plugins emitted once for each acknowledged App by Service. The App is not necessarily initialized yet

Properties:

• app
• Type: App

for serviser plugins.
emitted once for each instantiated Service object.

Properties:

• service
• Type: Service

const Service = require('serviser');

Service.on('service', function(service) {
    //do stuff
});

this event allows to hook-up serviser plugins and is static version of Service#event:set-up event.

Properties:

• appManager
• Type: AppManager

• service.appManager

• config
• Type: Config

• service.config

const Service = require('serviser');

Service.on('set-up', function(appManager, config) {
    //do stuff
});

for serviser plugins.
emitted once prior a shell command is dispatched. Allows to register custom user-defined shell commands. See serviser-shell plugin

Properties:

• yargs
• Type: Object