Removing proxy test+debugging output

[KiwiIRC.git] / server / websocketrpc.js

/*
    TODO:
    Create a document explaining the protocol
    Some way to expire unused callbacks? TTL? expireCallback() function?
*/

function WebsocketRpc(eio_socket) {
    var self = this;

    this._next_id = 0;
    this._rpc_callbacks = {};
    this._socket = eio_socket;

    this._mixinEmitter();
    this._bindSocketListeners();
}


WebsocketRpc.prototype._bindSocketListeners = function() {
    var self = this;

    // Proxy the onMessage listener
    this._onMessageProxy = function rpcOnMessageBoundFunction(){
        self._onMessage.apply(self, arguments);
    };
    this._socket.on('message', this._onMessageProxy);
};



WebsocketRpc.prototype.dispose = function() {
    if (this._onMessageProxy) {
        this._socket.removeListener('message', this._onMessageProxy);
        delete this._onMessageProxy;
    }

    this.removeAllListeners();
};




/**
 * The engine.io socket already has an emitter mixin so steal it from there
 */
WebsocketRpc.prototype._mixinEmitter = function() {
    var funcs = ['on', 'once', 'off', 'removeListener', 'removeAllListeners', 'emit', 'listeners', 'hasListeners'];

    for (var i=0; i<funcs.length; i++) {
        if (typeof this._socket[funcs[i]] === 'function')
            this[funcs[i]] = this._socket[funcs[i]];
    }
};


/**
 * Check if a packet is a valid RPC call
 */
WebsocketRpc.prototype._isCall = function(packet) {
    return (typeof packet.method !== 'undefined' &&
            typeof packet.params !== 'undefined');
};


/**
 * Check if a packet is a valid RPC response
 */
WebsocketRpc.prototype._isResponse = function(packet) {
    return (typeof packet.id !== 'undefined' &&
            typeof packet.response !== 'undefined');
};



/**
 * Make an RPC call
 * First argument must be the method name to call
 * If the last argument is a function, it is used as a callback
 * All other arguments are passed to the RPC method
 * Eg. Rpc.call('namespace.method_name', 1, 2, 3, callbackFn)
 */
WebsocketRpc.prototype.call = function(method) {
    var params, callback, packet;

    // Get a normal array of passed in arguments
    params = Array.prototype.slice.call(arguments, 1, arguments.length);

    // If the last argument is a function, take it as a callback and strip it out
    if (typeof params[params.length-1] === 'function') {
        callback = params[params.length-1];
        params = params.slice(0, params.length-1);
    }

    packet = {
        method: method,
        params: params
    };

    if (typeof callback === 'function') {
        packet.id = this._next_id;

        this._next_id++;
        this._rpc_callbacks[packet.id] = callback;
    }

    this.send(packet);
};


/**
 * Encode the packet into JSON and send it over the websocket
 */
WebsocketRpc.prototype.send = function(packet) {
    if (this._socket)
        this._socket.send(JSON.stringify(packet));
};


/**
 * Handler for the websocket `message` event
 */
WebsocketRpc.prototype._onMessage = function(message_raw) {
    var self = this,
        packet,
        returnFn,
        callback;

    try {
        packet = JSON.parse(message_raw);
        if (!packet) throw 'Corrupt packet';
    } catch(err) {
        return;
    }

    if (this._isResponse(packet)) {
        // If we have no callback waiting for this response, don't do anything
        if (typeof this._rpc_callbacks[packet.id] !== 'function')
            return;

        // Delete the callback before calling it. If any exceptions accur within the callback
        // we don't have to worry about the delete not happening
        callback = this._rpc_callbacks[packet.id];
        delete this._rpc_callbacks[packet.id];

        callback.apply(this, packet.response);

    } else if (this._isCall(packet)) {
        // Calls with an ID may be responded to
        if (typeof packet.id !== 'undefined') {
            returnFn = this._createReturnCallFn(packet.id);
        } else {
            returnFn = this._noop;
        }

        this.emit.apply(this, [packet.method, returnFn].concat(packet.params));
    }
};


/**
 * Returns a function used as a callback when responding to a call
 */
WebsocketRpc.prototype._createReturnCallFn = function(packet_id) {
    var self = this;

    return function returnCallFn() {
        var value = Array.prototype.slice.call(arguments, 0);

        var ret_packet = {
            id: packet_id,
            response: value
        };

        self.send(ret_packet);
    };
};



WebsocketRpc.prototype._noop = function() {};




// If running a node module, set the exports
if (typeof module === 'object' && typeof module.exports !== 'undefined') {
    module.exports = WebsocketRpc;
}