Merge branch 'b1_expressCode'

1. Update project to run web server locally with nodejs and expressjs
2. Update project code to match ADS 3.2 WebSocket API
3. Revise README.md

Author: Wasin Waeosri

README.md

@@ -1,23 +1,30 @@
 # Elektron WebSocket API with Web Workers Example 
 ## Overview
 
-[Elektron WebSocket API](https://developers.thomsonreuters.com/elektron/websocket-api) enables easy integration into a multitude of client technology environments such as scripting and web.  This API runs directly on your TREP infrastructure or the Thomson Reuters platform and presents data in an open (JSON) readable format. The API supports all Thomson Reuters Elektron data models and can be integrated into multiple client technology standards e.g. Python, R, .Net etc.
+[Elektron WebSocket API](https://developers.thomsonreuters.com/websocket-api) enables easy integration into a multitude of client technology environments such as scripting and web.  This API runs directly on your TREP infrastructure or the Thomson Reuters platform and presents data in an open (JSON) readable format. The API supports all Thomson Reuters Elektron data models and can be integrated into multiple client technology standards e.g. Python, R, .Net etc.
 
 The web browsers JavaScript runtime is a single-threaded environment by default. However, the HTML standard lets developers implement multi threads JavaScript application in web browser by introducing the [Web Workers](https://html.spec.whatwg.org/multipage/workers.html) feature that lets web browsers run JavaScripts in a main thread and a background thread (workers thread).
 
 This example shows how to implement the Elektron WebSocket API with JavaScript web application with Web Workers. It lets the Web Workers thread handles a connection logic with ADS WebSocket while the main thread handles the UI interaction events and displaying data.
 
 There are two types of the Web Workers, [Dedicated Workers](https://html.spec.whatwg.org/multipage/workers.html#dedicated-workers-and-the-worker-interface) and [Shared Workers](https://html.spec.whatwg.org/multipage/workers.html#sharedworker). This example covers only how to implement the Elektron WebSocket API with JavaScript web browser application with Dedicated Workers.
 
+*Note: The initial release of this API is for deployed TREP customers only (i.e. to use it you will need an installed version of TREP 3.2). 
+
 ## Supported Web Browsers
 The example supports Chrome, Firefox and IE11 (based on the WebSocket and Web Workers browser supported platform).
 
 ## Prerequisite
-This example uses the following 3rd party libraries.
+This example requires the following dependencies softwares.
+1. [Node.js](https://nodejs.org/en/) - version 6.10 or higher.
+2. [npm](https://www.npmjs.com/) package manager (included in Node.js)
+3. [Express.js](https://expressjs.com/) framework
+
+This example also uses the following 3rd party libraries for UI presentation.
 1. [jQuery 3.2.1](https://jquery.com/) 
 2. [Bootstrap 3.3.7](https://getbootstrap.com/docs/3.3/)
 
-Both of jQuery and Bootstrap are distributed under the [MIT license](https://opensource.org/licenses/MIT). Please see more detail in the LICENSE.md file. 
+jQuery,Bootstrap and Express.js are distributed under the [MIT license](https://opensource.org/licenses/MIT). Please see more detail in the LICENSE.md file. 
 
 ## Example files and folders
 The web application contains the following example files and folder:
@@ -27,14 +34,29 @@ The web application contains the following example files and folder:
 4. css/cover.css: The application CSS file
 5. libs/jquery-3.2.1.min.js: jQuery library file
 6. bootstrap/css, bootstarp/fonts and bootstrap/js folders: The folders for Bootstrap CSS and libraries files
+7. node_modules folder: Folder for Node.js and Express.js modules for web server running
+8. server.js: A web server application
+9. package.json: The Project npm dependencies file. 
 
 ## How to run this example
-1. Deploy the project in any web server (recommend [http-server](https://www.npmjs.com/package/http-server) for quick dev/testing)
-2. Open <web server>/index.html in the web browsers (IE11, Chorme and Firefox)
+1. Unzip or download the example project folder into a directory of your choice 
+2. Run ```$> npm install``` in the command prompt to install all the dependencies required to run the sample in a subdirectory called *node_modules/*.
+
+![npm command display](images/npm_install.png "npm command display")
+
+3. If the machine is behind a proxy server, you need to configure Node.js uses proxy instead of a direct HTTP connection via the following command in command prompt: ```set https_proxy=http://<proxy.server>:<port>```
+4. Run ```$> node server.js``` in the command prompt to start the web server at HTTP port 3000
+
+![application display](images/run_server.png "run server")
+
+5. Open web browser (IE11, Chorme and Firefox), then navigate to index.html of the web server at ```http://localhost:300/index.html```
+
+![application display](images/application_screen.png "application display")
+
 
 ## References
 For further details, please check out the following resources:
-* [Thomson Reuters Elektron WebSocket API page](https://developers.thomsonreuters.com/elektron/websocket-api) on the [Thomson Reuters Developer Community](https://developers.thomsonreuters.com/) web site.
+* [Thomson Reuters Elektron WebSocket API page](https://developers.thomsonreuters.com/websocket-api) on the [Thomson Reuters Developer Community](https://developers.thomsonreuters.com/) web site.
 * [Mozilla Developer Network: Web Workers API page](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API).
 * [Google HTML5 Rocks: The Basics of Web Workers page](https://www.html5rocks.com/en/tutorials/workers/basics/)
 

images/application_screen.png

@@ -0,0 +1,14 @@
+{
+  "name": "elecktron_ws_worker",
+  "version": "1.0.0",
+  "description": "The example project that provides how to implement JavaScript applicatiion with Web Workers for Elektron WebSocket API",
+  "main": "server.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "Wasin Waeosri <wasin.waeosri@thomsonreuters.com> (https://developers.thomsonreuters.com/)",
+  "license": "MIT",
+  "dependencies": {
+    "express": "^4.16.2"
+  }
+}

images/npm_install.png

@@ -0,0 +1,16 @@
+const express = require('express');
+let path = require('path');
+
+const web_path = path.join(__dirname, './');
+
+const app = express();
+const port = 3000;
+
+app.use(express.static(web_path));
+
+app.get("*", function(req,res){
+    res.sendFile(path.join(web_path,"index.html"));
+});
+
+
+app.listen(port, ()=> console.log(`Application is running at port ${port}`));