Merge branch 'v5_revisecodeandCDN'

Update project to bundle with jQuery and Bootstrap libraries (with
license declare).

Update README.md to match project detail.

Author: Wasin Waeosri

.gitignore

@@ -1,3 +1 @@
-libs/jquery-3.2.1.min.js
-bootstrap/
 test.html

LICENSE.md

@@ -0,0 +1,7 @@
+Copyright 2017 Thomson Reuters
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -3,33 +3,39 @@
 
 [Elektron WebSocket API](https://developers.thomsonreuters.com/elektron/websocket-api-early-access) 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. This limitation makes JavaScript cannot concurrent handles UI events, query, data processing and network connection logic which causes the UI blocking scenario in the web browsers. The HTML standard's introduces the [Web Workers](https://html.spec.whatwg.org/multipage/workers.html) to solve this issue. It lets web browsers run JavaScripts in background threads without blocking the UI. It can perform I/O, XMLHttpRequest and the WebSocket connection in a background thread while the main JavaScript thread handles UI interaction. 
+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).
 
-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. The example lets the Web Workers handle a connection logic with Elektron WebSocket API in a separate thread while the main thread handles the UI events and displaying data. 
+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.
 
 ## Supported Web Browsers
-The example supports Chrome, Firefox and IE11 (based on the WebSocket and Web Workers browser supported).
+The example supports Chrome, Firefox and IE11 (based on the WebSocket and Web Workers browser supported platform).
 
 ## Prerequisite
-The following libraries are required for this example. They are need to be downloaded separately:
-1. [jQuery 3.2.1](https://jquery.com/)
+This example uses the following 3rd party libraries.
+1. [jQuery 3.2.1](https://jquery.com/) 
 2. [Bootstrap 3.3.7](https://getbootstrap.com/docs/3.3/)
 
-## Example files
+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. 
+
+## Example files and folders
 The web application contains the following example files and folder:
 1. index.html: The application HTML page
 2. app/market_price_app.js: The application main file
 3. app/ws_workers.js: The application Web Workers file
 4. css/cover.css: The application CSS file
-5. libs/jquery-3.2.1.min.js: jQuery library file (need to be downloaded separately)
-6. bootstrap/css, bootstarp/fonts and bootstrap/js folders: The folders for Bootstrap CSS and libraries files (need to be downloaded separately)
+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
 
 ## How to run this example
-1. Deploy the project in any web server
-2. Open <web server>/index.html in the web browser (IE11, Chorme and Firefox)
+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)
 
 ## References
 For further details, please check out the following resources:
 * [Thomson Reuters Elektron WebSocket API page](https://developers.thomsonreuters.com/elektron/websocket-api-early-access) 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/)
+
+For any question related to this article or Elektron WebSocket API page, please use the Developer Community [Q&A Forum](https://community.developers.thomsonreuters.com/).

app/market_price_app.js

@@ -1,3 +1,12 @@
+//******************************************************************************************/
+// The market_price_app.js is a main application file. 
+// It handles all UI interactions. 
+// It sends and receives messages with ws_workers.js file to communicate with ADS WebSocket.
+
+// Author: Wasin Waeosri
+// Version: 1.0
+// Date: 7 November 2017
+//******************************************************************************************/
 (function ($) {
     //Define variables
     var serverurl = '',
@@ -196,7 +205,7 @@
         wk.postMessage(pongObj);
 
         //$('#commandsPre').html(`Sending Client Pong: ws.send(${JSON.stringify({ 'Type': 'Pong' }, undefined, 2)});`);
-        $('#commandsPre').html('Sending Client Pong: ws.send(' + JSON.stringify({ 'Type': 'Pong' }, undefined, 2) + ');');
+        $('#commandsPre').html('Sending Client Pong to Web Workers: WebWorkers.post(' + JSON.stringify({ 'Type': 'Pong' }, undefined, 2) + ');');
     }
 
     //Send Login Close Request message to ADS WebSocket
@@ -215,7 +224,7 @@
         wk.postMessage(closeloginrequestObj);
 
         //$('#commandsPre').html(`Sending Login Close Request: ws.send(${JSON.stringify(closeloginrequestMsg, undefined, 2)});`);
-        $('#commandsPre').html('Sending Login Close Request: ws.send(' + JSON.stringify(closeloginrequestMsg, undefined, 2) + ');');
+        $('#commandsPre').html('Sending Login Close Request to Web Workers: WebWorkers.post(' + JSON.stringify(closeloginrequestMsg, undefined, 2) + ');');
     }
 
 })($);

app/ws_workers.js

@@ -1,3 +1,12 @@
+//******************************************************************************************/
+// The ws_workers.js is an application Web Workers file. 
+// It handles all communications with ADS WebSocket. 
+
+// Author: Wasin Waeosri
+// Version: 1.0
+// Date: 7 November 2017
+//******************************************************************************************/
+
 (function () {
 
     //Define WebSocket and protocol variables