Service Provider Tutorial

This tutorial will explain how to create and use a service provider.

A Service Provider registers services that provide features for MeeseOS.

Service Providers have the same interface and initialization/startup procedure in both client and server.

Usage

To create an instance of a service provided:

core.make("service-name", ...args);

Custom Service Provider

This is the service provider interface:

class ServiceProvider {
  constructor(core, options = {}) {
    this.core = core;
    this.options = options;
  }

  /** The list of registered services */
  provides() {
    return [];
  }

  /** An optional list of dependant services */
  depends() {
    return [];
  }

  /** Initialize your services */
  async init() {}

  /** Start your services. Runs after all services has been init-ed */
  start() {}

  /** Clean up */
  destroy() {}
}

See service provider guide for more info.

To generate a new provider using the example via CLI run npm run make:provider.

For general information about development see development article.

Instance factory

To register a factory:

core.instance("service-name", (...args) => new SomeClass(...args));

Singleton factory

To register a singleton:

core.singleton("service-name", () => new SomeClass({ foo: "bar" }));

Basic example

// src/client/myprovider.js
export class MyApiServiceProvider {
  constructor(core, options = {}) {
    this.core = core;
    this.options = options;
  }

  provides() {
    return ["namespace/api"];
  }

  async init() {
    this.core.singleton("namespace/api", () => ({
      greet: name => alert(`Hello ${name}!`)
    }));
  }
}

// src/client/index.js
import {MyApiServiceProvider} from "./myprovider.js";

// ...
meeseOS.register(MyApiServiceProvider);
// ...

You can test this by entering the following in your browser developer console:

meeseOS.make("namespace/api").greet("World");

and you should see a browser alert box.

Service Provider