[THRIFT-2355] Add SSL and Web Socket Support to Node and JavaScript

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 0.9.2
• Fix Version/s: 0.9.2
• Component/s: JavaScript - Compiler, JavaScript - Library, Node.js - Library

Environment

all

• Patch Info: Patch Available
• Assignee: Randy Abernethy
• Reporter: Randy Abernethy
• Created: 09/Feb/14 16:16
• Updated: 19/Mar/14 14:03
• Resolved: 19/Mar/14 14:03

Description

This patch adds support for SSL between Node.js and Browser JavaScript as well as initial WebSocket transport support.

The createStaticHTTPThriftServer() method has been renamed createWebServer(). The resulting server supports XHR based HTTP:// and HTTPS:// clients as well as upgrades to WS:// and WSS:// for websocket clients.

The JavaScript thrift.js library now includes websocket support through TWebSocketTransport. The old XHR transport still goes by the alias Transport but can now also be accessed through the name TXHRTransport. Browser clients can use XHR over HTTP and HTTPS (as always) and also WebSocket (WS://) and secure WebSocket (WSS://).

The JavaScript grunt build runs jQuery and Normal JavaScript synchronous and asynchronous tests over HTTP and HTTPS. There are now three test drivers in the thrift/lib/js/test directory:

• test.html the jQuery build test (thrift -gen js:jquery)
• test-nojq.html the normal JavaScript build test (thrift -gen js)
• testws.html the web socket test.

The thrift/test/keys directory supplies the key and cert for the HTTPS test server.

The root js README was updated and contains a complete client/server example. A new README was added to the test directory providing an orientation there.

With WebSocket in place it makes sense to consider adding a binary protocol on the browser side.

Issue Links

• supercedes: THRIFT-1683 Implement alternatives to Javascript Client side Transport protocol, just as NPAPI and WebSocket.