From a42ec32c98b6e33d0adef68ec02ca891d5d1658b Mon Sep 17 00:00:00 2001
From: Joshua Spence <josh@joshuaspence.com>
Date: Thu, 29 May 2014 07:04:12 -0700
Subject: [PATCH] Modify the Aphlict client to use `LocalConnection`.

Summary:
Ref T4324. Currently, an Aphlict client (with a corresponding connection to the Aphlict Server) is created for every tab that a user has open. This significantly affects the scalability of Aphlict as a service. Instead, we can use `LocalConnection` instances to coordinate the communication of multiple Aphlict clients to the server.

Similar functionality existed prior to D2704, but was removed as the author was not able to get this functionality working as intended. It seems that the main issue with the initial attempt was the use of the `setTimeout` function, which seemed to be a blocking call which prevented messages from being received. I have instead used an event-based model using a `Timer` object.

Roughly this works as follows:

# The first instance will create an `AphlictClient` and an `AphlictMaster`. The `AphlictClient` will register itself with the `AphlictMaster` and will consequently be notified of incoming messages.
# The `AphlictClient` is then responsible for pinging the `AphlictMaster` at regular intervals. If the client does not ping the master in a given period of time, the master will assume that the client is dead and will remove the client from the pool.
# Similarly, the `AphlictMaster` is required to respond to pings with a "pong" response. The pong response lets the clients know that the `AphlictMaster` is still alive. If the clients do not receive a pong in a given period of time, then the clients will attempt to spawn a new master.

Test Plan: I have tested this on our Phabricator install with a few tabs opened and inspecting the console output. I will upload a screencast of my test results.

Reviewers: #blessed_reviewers, epriestley

Reviewed By: #blessed_reviewers, epriestley

Subscribers: epriestley, Korvin

Maniphest Tasks: T4324

Differential Revision: https://secure.phabricator.com/D9327
---
 .../aphlict/client/build_aphlict_client.sh    |  13 +-
 support/aphlict/client/src/Aphlict.as         | 113 ++----------
 support/aphlict/client/src/AphlictClient.as   | 129 ++++++++++++++
 support/aphlict/client/src/AphlictMaster.as   | 166 ++++++++++++++++++
 webroot/rsrc/swf/aphlict.swf                  | Bin 7217 -> 9213 bytes
 5 files changed, 315 insertions(+), 106 deletions(-)
 create mode 100644 support/aphlict/client/src/AphlictClient.as
 create mode 100644 support/aphlict/client/src/AphlictMaster.as

diff --git a/support/aphlict/client/build_aphlict_client.sh b/support/aphlict/client/build_aphlict_client.sh
index b328873d19..f081c9f0d2 100755
--- a/support/aphlict/client/build_aphlict_client.sh
+++ b/support/aphlict/client/build_aphlict_client.sh
@@ -9,20 +9,13 @@ if [ -z "$MXMLC" ]; then
 fi;
 
 set -e
-set -x
 
-# cp -R $ROOT/externals/vegas/src $BASEDIR/src/vegas
-
-(cd $BASEDIR && $MXMLC \
-  -output aphlict.swf \
+$MXMLC \
+  -output=$ROOT/webroot/rsrc/swf/aphlict.swf \
   -default-background-color=0x444444 \
   -default-size=500,500 \
   -warnings=true \
   -debug=true \
   -source-path=$ROOT/externals/vegas/src \
   -static-link-runtime-shared-libraries=true \
-  src/Aphlict.as)
-
-mv $BASEDIR/aphlict.swf $ROOT/webroot/rsrc/swf/aphlict.swf
-
-#  -target-player=10.2.0 \
+  $BASEDIR/src/AphlictClient.as
diff --git a/support/aphlict/client/src/Aphlict.as b/support/aphlict/client/src/Aphlict.as
index 14eb9548db..d61ad04b0a 100644
--- a/support/aphlict/client/src/Aphlict.as
+++ b/support/aphlict/client/src/Aphlict.as
@@ -1,117 +1,38 @@
 package {
 
-  import flash.net.*;
-  import flash.utils.*;
-  import flash.media.*;
-  import flash.display.*;
-  import flash.events.*;
+  import flash.display.Sprite;
   import flash.external.ExternalInterface;
+  import flash.net.LocalConnection;
 
-  import vegas.strings.JSON;
 
   public class Aphlict extends Sprite {
 
-    private var client:String;
+    /**
+     * A transport channel used to receive data.
+     */
+    protected var recv:LocalConnection;
 
-    private var socket:Socket;
-    private var readBuffer:ByteArray;
+    /**
+     * A transport channel used to send data.
+     */
+    protected var send:LocalConnection;
 
-    private var remoteServer:String;
-    private var remotePort:Number;
 
     public function Aphlict() {
       super();
 
-      ExternalInterface.addCallback('connect', this.externalConnect);
-      ExternalInterface.call(
-        'JX.Stratcom.invoke',
-        'aphlict-component-ready',
-        null,
-        {});
+      this.recv = new LocalConnection();
+      this.recv.client = this;
+
+      this.send = new LocalConnection();
     }
 
-    public function externalConnect(server:String, port:Number):void {
-      this.externalInvoke('connect');
-
-      this.remoteServer = server;
-      this.remotePort   = port;
-
-      this.connectToServer();
-    }
-
-
-    public function connectToServer():void {
-      var socket:Socket = new Socket();
-
-      socket.addEventListener(Event.CONNECT,              didConnectSocket);
-      socket.addEventListener(Event.CLOSE,                didCloseSocket);
-      socket.addEventListener(ProgressEvent.SOCKET_DATA,  didReceiveSocket);
-
-      socket.addEventListener(IOErrorEvent.IO_ERROR,      didIOErrorSocket);
-      socket.addEventListener(
-        SecurityErrorEvent.SECURITY_ERROR,
-        didSecurityErrorSocket);
-
-      socket.connect(this.remoteServer, this.remotePort);
-
-      this.readBuffer = new ByteArray();
-      this.socket = socket;
-    }
-
-    private function didConnectSocket(event:Event):void {
-      this.externalInvoke('connected');
-    }
-
-    private function didCloseSocket(event:Event):void {
-      this.externalInvoke('close');
-    }
-
-    private function didIOErrorSocket(event:IOErrorEvent):void {
-      this.externalInvoke('error', event.text);
-    }
-
-    private function didSecurityErrorSocket(event:SecurityErrorEvent):void {
-      this.externalInvoke('error', event.text);
-    }
-
-    private function didReceiveSocket(event:Event):void {
-      var b:ByteArray = this.readBuffer;
-      this.socket.readBytes(b, b.length);
-
-      do {
-        b = this.readBuffer;
-        b.position = 0;
-
-        if (b.length <= 8) {
-          break;
-        }
-
-        var msg_len:Number = parseInt(b.readUTFBytes(8), 10);
-        if (b.length >= msg_len + 8) {
-          var bytes:String = b.readUTFBytes(msg_len);
-          var data:Object = vegas.strings.JSON.deserialize(bytes);
-          var t:ByteArray = new ByteArray();
-          t.writeBytes(b, msg_len + 8);
-          this.readBuffer = t;
-
-          this.receiveMessage(data);
-        } else {
-          break;
-        }
-      } while (true);
-
-    }
-
-    public function receiveMessage(msg:Object):void {
-      this.externalInvoke('receive', msg);
-    }
-
-    public function externalInvoke(type:String, object:Object = null):void {
+    protected function externalInvoke(type:String, object:Object = null):void {
       ExternalInterface.call('JX.Aphlict.didReceiveEvent', type, object);
     }
 
-    public function log(message:String):void {
-      ExternalInterface.call('console.log', message);
+    protected function log(message:String):void {
+      this.externalInvoke('log', message);
     }
 
   }
diff --git a/support/aphlict/client/src/AphlictClient.as b/support/aphlict/client/src/AphlictClient.as
new file mode 100644
index 0000000000..31105c67d1
--- /dev/null
+++ b/support/aphlict/client/src/AphlictClient.as
@@ -0,0 +1,129 @@
+package {
+
+  import flash.events.TimerEvent;
+  import flash.external.ExternalInterface;
+  import flash.utils.Timer;
+
+
+  public class AphlictClient extends Aphlict {
+
+    /**
+     * The connection name for this client. This will be used for the
+     * @{class:LocalConnection} object.
+     */
+    private var client:String;
+
+    /**
+     * The expiry timestamp for the @{class:AphlictMaster}. If this time is
+     * elapsed then the master will be assumed to be dead and another
+     * @{class:AphlictClient} will create a master.
+     */
+    private var expiry:Number = 0;
+
+    /**
+     * The interval at which to ping the @{class:AphlictMaster}.
+     */
+    public static const INTERVAL:Number = 3000;
+
+    private var master:AphlictMaster;
+    private var timer:Timer;
+
+    private var remoteServer:String;
+    private var remotePort:Number;
+
+
+    public function AphlictClient() {
+      super();
+
+      ExternalInterface.addCallback('connect', this.externalConnect);
+      ExternalInterface.call(
+        'JX.Stratcom.invoke',
+        'aphlict-component-ready',
+        null,
+        {});
+    }
+
+    public function externalConnect(server:String, port:Number):void {
+      this.externalInvoke('connect');
+
+      this.remoteServer = server;
+      this.remotePort   = port;
+
+      this.client = AphlictClient.generateClientId();
+      this.recv.connect(this.client);
+
+      this.timer = new Timer(AphlictClient.INTERVAL);
+      this.timer.addEventListener(TimerEvent.TIMER, this.keepalive);
+
+      this.connectToMaster();
+    }
+
+    /**
+     * Generate a unique identifier that will be used to communicate with the
+     * @{class:AphlictMaster}.
+     */
+    private static function generateClientId():String {
+      return 'aphlict_client_' + Math.round(Math.random() * 100000);
+    }
+
+    /**
+     * Create a new connection to the @{class:AphlictMaster}.
+     *
+     * If there is no current @{class:AphlictMaster} instance, then a new master
+     * will be created.
+     */
+    private function connectToMaster():void {
+      this.timer.stop();
+
+      // Try to become the master.
+      try {
+        this.log('Attempting to become the master...');
+        this.master = new AphlictMaster(this.remoteServer, this.remotePort);
+        this.log('I am the master.');
+      } catch (x:Error) {
+        // Couldn't become the master
+        this.log('Cannot become the master... probably one already exists');
+      }
+
+      this.send.send('aphlict_master', 'register', this.client);
+      this.expiry = new Date().getTime() + (5 * AphlictClient.INTERVAL);
+      this.log('Registered client ' + this.client);
+
+      this.timer.start();
+    }
+
+    /**
+     * Send a keepalive signal to the @{class:AphlictMaster}.
+     *
+     * If the connection to the master has expired (because the master has not
+     * sent a heartbeat signal), then a new connection to master will be
+     * created.
+     */
+    private function keepalive(event:TimerEvent):void {
+      if (new Date().getTime() > this.expiry) {
+        this.connectToMaster();
+      }
+
+      this.send.send('aphlict_master', 'ping', this.client);
+    }
+
+    /**
+     * This function is used to receive the heartbeat signal from the
+     * @{class:AphlictMaster}.
+     */
+    public function pong():void {
+      this.expiry = new Date().getTime() + (2 * AphlictClient.INTERVAL);
+    }
+
+    /**
+     * Receive a message from the Aphlict Server, via the
+     * @{class:AphlictMaster}.
+     */
+    public function receiveMessage(msg:Object):void {
+      this.log('Received message.');
+      this.externalInvoke('receive', msg);
+    }
+
+  }
+
+}
diff --git a/support/aphlict/client/src/AphlictMaster.as b/support/aphlict/client/src/AphlictMaster.as
new file mode 100644
index 0000000000..1991ab48bd
--- /dev/null
+++ b/support/aphlict/client/src/AphlictMaster.as
@@ -0,0 +1,166 @@
+package {
+
+  import flash.events.Event;
+  import flash.events.IOErrorEvent;
+  import flash.events.ProgressEvent;
+  import flash.events.SecurityErrorEvent;
+  import flash.events.TimerEvent;
+  import flash.net.Socket;
+  import flash.utils.ByteArray;
+  import flash.utils.Dictionary;
+  import flash.utils.Timer;
+  import vegas.strings.JSON;
+
+
+  public class AphlictMaster extends Aphlict {
+
+    /**
+     * The pool of connected clients.
+     */
+    private var clients:Dictionary;
+
+    /**
+     * A timer used to trigger periodic events.
+     */
+    private var timer:Timer;
+
+    /**
+     * The interval after which clients will be considered dead and removed
+     * from the pool.
+     */
+    public static const PURGE_INTERVAL:Number = 3 * AphlictClient.INTERVAL;
+
+    /**
+     * The hostname for the Aphlict Server.
+     */
+    private var remoteServer:String;
+
+    /**
+     * The port number for the Aphlict Server.
+     */
+    private var remotePort:Number;
+
+    private var socket:Socket;
+    private var readBuffer:ByteArray;
+
+
+    public function AphlictMaster(server:String, port:Number) {
+      super();
+
+      this.remoteServer = server;
+      this.remotePort   = port;
+
+      // Connect to the Aphlict Server.
+      this.recv.connect('aphlict_master');
+      this.connectToServer();
+
+      this.clients = new Dictionary();
+
+      // Start a timer and regularly purge dead clients.
+      this.timer = new Timer(AphlictMaster.PURGE_INTERVAL);
+      this.timer.addEventListener(TimerEvent.TIMER, this.purgeClients);
+      this.timer.start();
+    }
+
+    /**
+     * Register a @{class:AphlictClient}.
+     */
+    public function register(client:String):void {
+      if (!this.clients[client]) {
+        this.log('Registering client: ' + client);
+        this.clients[client] = new Date().getTime();
+      }
+    }
+
+    /**
+     * Purge stale client connections from the client pool.
+     */
+    private function purgeClients(event:TimerEvent):void {
+      for (var client:String in this.clients) {
+        var checkin:Number = this.clients[client];
+
+        if (new Date().getTime() - checkin > AphlictMaster.PURGE_INTERVAL) {
+          this.log('Purging client: ' + client);
+          delete this.clients[client];
+        }
+      }
+    }
+
+    /**
+     * Clients will regularly "ping" the master to let us know that they are
+     * still alive. We will "pong" them back to let the client know that the
+     * master is still alive.
+     */
+    public function ping(client:String):void {
+      this.clients[client] = new Date().getTime();
+      this.send.send(client, 'pong');
+    }
+
+    private function connectToServer():void {
+      var socket:Socket = new Socket();
+
+      socket.addEventListener(Event.CONNECT,              didConnectSocket);
+      socket.addEventListener(Event.CLOSE,                didCloseSocket);
+      socket.addEventListener(ProgressEvent.SOCKET_DATA,  didReceiveSocket);
+
+      socket.addEventListener(IOErrorEvent.IO_ERROR,      didIOErrorSocket);
+      socket.addEventListener(
+        SecurityErrorEvent.SECURITY_ERROR,
+        didSecurityErrorSocket);
+
+      socket.connect(this.remoteServer, this.remotePort);
+
+      this.readBuffer = new ByteArray();
+      this.socket = socket;
+    }
+
+    private function didConnectSocket(event:Event):void {
+      this.externalInvoke('connected');
+    }
+
+    private function didCloseSocket(event:Event):void {
+      this.externalInvoke('close');
+    }
+
+    private function didIOErrorSocket(event:IOErrorEvent):void {
+      this.externalInvoke('error', event.text);
+    }
+
+    private function didSecurityErrorSocket(event:SecurityErrorEvent):void {
+      this.externalInvoke('error', event.text);
+    }
+
+    private function didReceiveSocket(event:Event):void {
+      var b:ByteArray = this.readBuffer;
+      this.socket.readBytes(b, b.length);
+
+      do {
+        b = this.readBuffer;
+        b.position = 0;
+
+        if (b.length <= 8) {
+          break;
+        }
+
+        var msg_len:Number = parseInt(b.readUTFBytes(8), 10);
+        if (b.length >= msg_len + 8) {
+          var bytes:String = b.readUTFBytes(msg_len);
+          var data:Object = vegas.strings.JSON.deserialize(bytes);
+          var t:ByteArray = new ByteArray();
+          t.writeBytes(b, msg_len + 8);
+          this.readBuffer = t;
+
+          // Send the message to all clients.
+          for (var client:String in this.clients) {
+            this.log('Sending message to client: ' + client);
+            this.send.send(client, 'receiveMessage', data);
+          }
+        } else {
+          break;
+        }
+      } while (true);
+    }
+
+  }
+
+}
diff --git a/webroot/rsrc/swf/aphlict.swf b/webroot/rsrc/swf/aphlict.swf
index 4ac315b9de8a6669fe373cfbd9e5449814371dc2..bccd0f0d47070f7c0e31d73d8bc76a773f209dcf 100644
GIT binary patch
literal 9213
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
T7qYLRTR(h}dO-O<`+!RI$|eAh

literal 7217
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