Page Comparison

Objective

As known, SOAJS offers a wide range of solutions for APIs.

Assuming you are using a different technology, nodeJS based, now using the 'soajs.nodejs' middleware, you can benefit from all SOAJS advantages.

Source Code:

Objective

...

The NodeJS Middleware provides the ability to modernize existing API with SOAJ when this API is built using NodeJs as a development language.

The middleware exposes several functionality and configuration that SOAJS offers and which can be consumed by the API upon initialization or during runtime when requests arrive.

This page explains the NodeJs middleware; the functionality and configuration that it offers, how to install it and how to use it.

Scenario

...

1. How to Install 
2. Features
   1. Configuration
   2. Functionality
3. How does it work
   1. on init
   2. on request
4. Using the Middleware
   1. Initialization State
   2. Runtime State
5. Examples
   1. NodeJs Express
   2. NodeJs Hapi

1- How to Install

...

The SOAJS NodeJs middleware is open source and is available under Github, you can use the following reference to pull the source code → https://github.com/soajs/soajs.nodejs

This space will show you:

1. How does it work on init
2. How does it work on request
3. Practice
4. Express example
5. Hapi example

How does it work on init

Using the following environment variables:

• SOAJS_REGISTRY_API

• SOAJS_ENV

the middleware is going to invoke the controller and get the registry. Using the service configuration provided, the mw will auto reload the registry every "serviceConfig.awareness.autoRelaodRegistry"

Once the registry is loaded, the middleware is now ready to act on request.

How does it work on request

Once a request is reached, the SOAJS controller will be passing through the request headers a 'soajsinjectobj' which will be mapped within the middleware to the following standard object:

...

...

The middleware is also available as an NPM package and can be download for free.

# install from npm
npm install soajs.nodejs

The middleware can also be used as a dependency in your package.json file

{
	"dependencies": {
		"soajs.nodejs": "*"
	}
}

2- Features

...

Once the middleware is initialized, the following functionality becomes available:

This middleware functionality is accessible via the request that is made to the API. The middleware traps the request once it hits the API, injects its functionality and then hands it back to you to add your business logic. 

3-How does it work

...

On Init

The Middleware requires the following environment variables to be set prior to starting your service

Once your service starts, the middleware will make a call to the CON and retrieve the registry of the environment, it will cache it in memory.

From this registry, it uses variable autoReloadRegistry (which represents the auto reload duration in seconds) and every time this value is met, the middleware automatically pulls the new version of the registry and updates its cached version.

On request

SOAJS midlleware augments your service by trapping all arriving requests and injecting additional data then hands the updated version of request to your business logic.

The following table illustrates the data that gets injected by the middleware on every request:

tenant : {
    id : '',
    code : ''

...

}

key : {
    config : {},
    iKey : '',
    eKey : ''
},
device : 

...

'',
geo : {}

application : {
    product : '',
    package : '',
    appId : '',
    acl : {},
    acl_all_env : {}

...

}

package :{
    acl :{},
    acl_all_env : {}

...

}

urac : {}

...

awareness : {
    host : '',
    port : '',
    getHost : 'function',
	connect : 

...

'function'
}

Hence you can now use the following set of functions appended to req.soajs.reg:

{
  	getDatabases: returns database object if dbName provided, if not, return all core and tenant meta databases
	getServiceConfig: returns service configuration object
	getDeployer: returns deployer object
	getCustom: return custom object
	getResources: returns resource object if resourceName provided, if not returns all resources
	getServices: returns service object if serviceName provided, if not, returns all services
	getDaemons: returns daemon object if daemonName provided, if not, returns all daemons
	reload: reload registry
}

Practice

...

4- Using the Middleware

...

Once you download the middleware, simply require it and instruct the web application server to use it.

Consequently, anywhere in your APIs you can get your soajs object and use the data / functions as follows:, invoke req.soajs to access the data and functions that it offers.

// require the mw
const soajsMW = require('soajs.nodejs');

// pass it to your service app
app.use(soajsMW({ 	serviceName : 'testmy_service' }));

//...
use
it// in your requestsinvoke req.soajs
app.post('/helloworldfoo', function(req, res) => { 
	//...

	varlet soajs = req.soajs;
	// soajs.key.iKey;
	// soajs.reg.getDatabases(); });
});

...

console.log( JSON.stringify( soajs, null, 2 ) );

	//...
});

5- Examples

...

NodeJs Express

The following code snippets shows a basic example built using NodeJs Express Library and how the SOAJS NodeJs Middleware was added to the code to augment the web server created by express.

Full Example on: https://github.com/soajs/soajs.nodejs.express

'use strict';

//Create Express App
varconst express = require('express');
varconst app = express();

//Require SOAJS Middleware for NodeJs
const soajsMW = require('soajs.nodejs');

varconst url = require('url');

//Instruct the Express App to use the SOAJS Middleware
app.use(soajsMW({ serviceName : 'testmy_service' }));

//Invoke the middleware and use it in the Express app API
app.get('/tidbit/hello', function(req, res) => {
var
	let url_parts = url.parse(req.url, true);
var	let query = url_parts.query;

var	let username = query.username;
var	let lastname = query.lastname;

	res.send({
		"message": "Hello`Hello DEMO, I am an EXPRESS service, you are ["+username+" ${username} ] and your last name is : ["+lastname+"]",
dbs ${lastname} ]`,
		"dbs" : req.soajs.reg.getDatabases()
	});
});

//Invoke the middleware and use it in the Express app API
app.post('/tidbit/hello', function(req, res){

var	let response = req.soajs;

	req.soajs.awareness.getHost(function (host) => {

		response.controller = host;
		res.send(response);
	});
});

//Start the Express app and set it to listen on port 4382
app.listen(4382);

NodeJs Hapi

The following code snippets shows a basic example built using NodeJs Hapi Library and how the SOAJS NodeJs Middleware was added to the code to augment the web server created by hapi.

Full Example on: https://github.com/soajs/soajs.nodejs.expresshapi

Hapi Example

'use strict';

const Hapiurl = require('hapiurl');
const
soajsMW//Create = require('soajs.nodejs')({serviceName : 'test'});
var urlHapi  App
const Hapi = require('urlhapi');

const server = new Hapi.Server();

//Instruct the Hapi app to listen on port 4380
server.connection({
    host: '0.0.0.0', port: 4380 });

 port: 4380
});
//Require SOAJS Middleware for NodeJs
const soajsMW = require('soajs.nodejs')({serviceName : 'my_service'});

//Instruct the Hapi App to use the SOAJS Middleware
server.ext({
    type: 'onRequest',
    method: function (request, reply) => {
        soajsMW(request, reply, function (err) => {
            if (err) {
                throw err;
            }
            return reply.continue();
        });
    }
});

//Invoke the middleware and use it in the Express app API
server.route({
    method: 'GET',
    path: '/tidbit/hello',
    handler: function (request, reply) => {

	    varlet url_parts = url.parse(request.url, true);
	    varlet query = url_parts.query;

	    varlet username = query.username;
	    varlet lastname = query.lastname;

        return reply({
	        			"message": `Hello "HelloDEMO, I am aan HAPIHapi service, you are ["+username+" ${username} ] and your last name is : ["+lastname+"]" ${lastname} ]`,
			"dbs" : req.soajs.reg.getDatabases()
        });
    }
});

//Invoke the middleware and use it in the Express app API
server.route({ 	method: 'POST', 	path: '/tidbit/hello', 	handler: function (request, reply) => {

		varlet response = request.soajs;
		request.soajs.awareness.getHost(function (host) => {
			response.controller = host;
			return reply(response);
		});
	}
});

//Start the Hapi app server
server.start((err) => {

    if (err) {
        throw err;
    }
    console.log('Server running at:', server.info.uri);
});

...