@wbg-mde/server

MDE communication channel with Socket IO and express.

Usage no npm install needed!

<script type="module">
  import wbgMdeServer from 'https://cdn.skypack.dev/@wbg-mde/server';
</script>

README

Metadata Editor Server Module

Server module created to manage the bi-directional async requests in the MDE application. This module will be acted as a middle layer to communicate to the repository and r-factory requests.

SocketIO module

This module makes the application bi-directional communication between web clients and servers, Socket IO has two parts: Server side code and client-side code. This package contains the server side codes of MDE application.

Working methodology

The starting point of the application is the server.ts file, this is mentioned in the package.json. This file contains a method called start(), this method will be created an express server instance on a provided PORT. This method will be called from the main application under "electron.server" module. PORT and other related parameters will be provided as options from the main application.

To start server

press F5 to start server

Main socket module

This is the starting point to start the socket io server. Once the server is started it will create an instance of the "MainSocket" class and calls the init() method. This method will be created the server side socket instance and start the connection.

public init(http: any) {   
        const io = require('socket.io')(http);

        // #. Track connections
        io.on('connection', (socket) => {

            // #. Assign active socket
            this.socket = socket;

            // #. Track disconnect
            this.socket.on('disconnect', () => {
                console.log('disconnected');
            });

            this.initAll();
        });
    }
"initAll()" - method

Split the requests as seperate classes for easy handling. This method will create an instance of each classes after the socket connection established.

Example: Create a class to get the request for resequencing the variables

export class ResequenceSocket {
    private socket: any;
    constructor(activeSocket: any) {
        this.socket = activeSocket;
    }

    /*
    * Init resequence - Request will recieved here
    ************************************************/
    public init() {
        this.socket.on('resequence-req', (params: string) => {
            this.resequence(JSON.parse(params));
        });
    }

    private resequence(params: any) {
        rfactory.resequence.resequence(
            params.variables,
            params.filePath,
            params.projectId,
            params.rPath,
            params.language, (response: any) => {
                //#. Send responce to client - side
                this.socket.emit('resequence-res', { response, projectId: params.projectId, fileId: params.fileId })
            }
        );
    }
}

this class must be registered in the "ModuleSocket" class. ModuleSocket class will be crate the instance of the resequence class and start the socket listening by using 'resequence-req' key.

import { ResequenceSocket } from './modules';
export class ModuleSocket {
    constructor() {
    }

    public initAll(socket: any) {
        // #. Start resequence
        let resq = new ResequenceSocket(socket);
        resq.init();
    }
}

Once the socket established the connection, the "initAll" method from ModuleSocket will be called.

Use emit() method to send response to the client-side. In client Socket IO application expect the response key method to recieve the response.

Environment

  • Node 10.15.3
  • Express 4.16.4
  • socket.io 2.2.0
  • typescript 3.3.4

Contributors

  • Anoop Xavier (anoopx@panapps.co)
  • Navin VI (navin.v.i@panapps.co)
  • Libin Thomas (libint@panapps.co)
  • Ghanashyam C Kartha (ghanashyam.c.k@panapps.co)

License

MIT