sockjs · kdvolder · Nov 13, 2012 · Nov 13, 2012 · Nov 13, 2012 · Nov 13, 2012
diff --git a/LICENSE-MIT-SockJS b/LICENSE-MIT-SockJS
@@ -0,0 +1,19 @@
+Copyright (C) 2011 VMware, Inc.
+
+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.
diff --git a/README.md b/README.md
@@ -77,13 +77,20 @@ Protocol
 --------
 
 The underlying protocol is quite simple. Each message consists of
-three comma separated parts: _type_, _topic_ and _payload_. There are
+four comma separated parts: _type_, _topic_, _id and _payload_. There are
 three valid message types:
 
  * `sub` - expresses a will to subscribe to a given _topic_.
  * `msg` - a message with _payload_ is being sent on a _topic_.
  * `uns` - a will to unsubscribe from a _topic_.
 
+The _topic_ identifies a channel registered on the server side.
+
+The _id_ a unique connection identifier generated on the client side. Each 
+request to subscribe to a topic from a given client has a unique id.
+This makes it possible for a single client to open multiple independent
+channel connection to a single server-side service.
+
 Invalid messages like wrong unsubscriptions or publishes to a _topic_
 to which a client was not subscribed to are simply ignored.
 

diff --git a/copyright-notes.txt b/copyright-notes.txt
@@ -0,0 +1,4 @@
+We got permission from the original author of websocket multiplex to
+use the MIT-license. See here:
+
+https://github.com/sockjs/websocket-multiplex/issues/3
diff --git a/examples/simul-socks/client.js b/examples/simul-socks/client.js
@@ -0,0 +1,67 @@
+/*global require setTimeout console SockJS WebSocketMultiplex */
+
+(function () {
+
+	var MULTIPLEX = true;
+	var multiplexer = null;
+
+	function getMultiplexer() {
+		if (!multiplexer) {
+			var sockjs = new SockJS('/multiplexer');
+			multiplexer = new WebSocketMultiplex(sockjs);
+		}
+		return multiplexer;
+	}
+
+	function createSocket(name) {
+		if (MULTIPLEX) {
+			return getMultiplexer().channel(name);			
+		} else {
+			return new SockJS('/'+name);
+		}
+	}
+
+	function talkToTheSocket(myName, interval) {
+		var sock = createSocket('echo');
+
+		function log(msg) {
+			console.log('['+myName+'] '+msg);
+		}
+
+		function send(msg) {
+			log('>> '+msg);
+			sock.send(msg);
+		}
+
+		function conversation(i) {
+			if (i < 10) {
+				send(myName + " says "+i);
+				setTimeout(function () {
+					conversation(i+1);
+				}, interval);
+			} else {
+				sock.close();
+				setTimeout(function () {
+					send(myName + 'talking to closed connection, should be dropped');
+				}, interval);			
+			}
+		}
+
+		sock.onopen = function () {
+			log(' initiates a conversation');
+			conversation(0);
+		};
+		sock.onmessage = function (e) {
+			log('<< ' + e.data);
+		};
+		sock.onclose = function () {
+			log(' is leaving');
+		};
+
+	}
+
+	//Ann and Bob are talking to the same service at the same time
+	talkToTheSocket('Bob', 2000); 
+	talkToTheSocket('Ann', 1500);
+
+}());
diff --git a/examples/simul-socks/index.html b/examples/simul-socks/index.html
@@ -0,0 +1,11 @@
+<!doctype html>
+<html>
+<head>
+	<title>This page is blank... look in the jsconsole for some output</title>
+    <script src="http://cdn.sockjs.org/sockjs-0.3.min.js"></script>
+    <script src="multiplex.js"></script>
+    <script src="client.js"></script>
+</head>
+<body>
+ <p>This page is blank... look in the jsconsole for some output</p>
+</body>
diff --git a/examples/simul-socks/package.json b/examples/simul-socks/package.json
@@ -0,0 +1,8 @@
+{
+    "name"         : "websocket-multiplex-sockjs-example",
+    "version"      : "0.0.0-unreleasable",
+    "dependencies" : {
+        "express" : "2.5.8",
+        "sockjs" : "0.3.x"
+    }
+}