API docs: core.application

(constructor)(parent)

Create an application with the given parent context

(constructor)(config, parent)

Create an application with the given configuration and parent context

options

readonly

ApplicationConfig

state

readonly

string

Get the state of the application. The initial state is created and it can transition as follows by start and stop:

1. start - !started -> starting -> started - started -> started (no-op) 2. stop - (started | initialized) -> stopping -> stopped - ! (started || initialized) -> stopped (no-op)

Two types of states are expected: - stable, such as started and stopped - in process, such as booting and starting

Operations such as start and stop can only be called at a stable state. The logic should immediately set the state to a new one indicating work in process, such as starting and stopping.

assertInStates(op, states)

protected

Assert current state of the application to be one of the expected values

assertNotInProcess(op)

protected

Assert there is no other operation is in progress, i.e., the state is not *ing, such as starting or stopping.

awaitState(state)

protected

component(componentCtor, nameOrOptions)

Add a component to this application and register extensions such as controllers, providers, and servers from the component.

controller(controllerCtor, nameOrOptions)

Register a controller class with this application.

getServer(target)

Retrieve the singleton instance for a bound server.

init()

Initialize the application, and all of its registered observers. The application state is checked to ensure the integrity of initialize.

If the application is already initialized, no operation is performed.

This method is automatically invoked by start() if the application is not initialized.

interceptor(interceptor, nameOrOptions)

Register an interceptor

lifeCycleObserver(ctor, nameOrOptions)

Register a life cycle observer class

onInit(fn)

Register a function to be called when the application initializes.

This is a shortcut for adding a binding for a LifeCycleObserver implementing a init() method.

onStart(fn)

Register a function to be called when the application starts.

This is a shortcut for adding a binding for a LifeCycleObserver implementing a start() method.

onStop(fn)

Register a function to be called when the application starts.

This is a shortcut for adding a binding for a LifeCycleObserver implementing a start() method.

server(ctor, nameOrOptions)

Bind a Server constructor to the Application’s master context. Each server constructor added in this way must provide a unique prefix to prevent binding overlap.

servers(ctors)

Bind an array of Server constructors to the Application’s master context. Each server added in this way will automatically be named based on the class constructor name with the “servers.” prefix.

service(cls, nameOrOptions)

Add a service to this application.

setMetadata(metadata)

Set application metadata. @loopback/boot calls this method to populate the metadata from package.json.

setState(state)

protected

Transition the application to a new state and emit an event

setupShutdown()

protected

Set up signals that are captured to shutdown the application

start()

Start the application, and all of its registered observers. The application state is checked to ensure the integrity of start.

If the application is not initialized, it calls first init() to initialize the application. This only happens if start() is called for the first time.

If the application is already started, no operation is performed.

stop()

Stop the application instance and all of its registered observers. The application state is checked to ensure the integrity of stop.

If the application is already stopped or not started, no operation is performed.