PretendYoureXyzzy/WebContent/js/cah.ajax.js

/**
 * AJAX utility functions for cah. Core library. Individual handlers should be elsewhere.
 * 
 * @author ajanata
 */

cah.ajax = {};
cah.ajax.ErrorHandlers = {};
cah.ajax.SuccessHandlers = {};

/**
 * Create a new cah ajax helper.
 * 
 * @returns {cah.ajax.lib}
 * @constructor
 */
cah.ajax.lib = function() {
  // TODO run a timer to see if we have more than X pending requests and delay further ones until
  // we get results
  this.pendingRequests = {};
  this.serial = 0;
};

$(document).ready(function() {
  /**
   * Singleton instance for ajax utility.
   * 
   * @type {cah.ajax.lib}
   */
  cah.Ajax = new cah.ajax.lib();
  $.ajaxSetup({
    cache : false,
    context : cah.Ajax,
    error : cah.Ajax.error,
    success : cah.Ajax.done,
    timeout : cah.DEBUG ? undefined : 10 * 1000, // 10 second timeout for normal requests
    // timeout : 1, // 10 second timeout for normal requests
    type : 'POST',
    url : '/cah/AjaxServlet'
  });
});

/**
 * Send an ajax request to the server, and store that the request was sent so we know when it gets
 * responded to.
 * 
 * This should be used for data sent to the server, not long-polling.
 * 
 * @param {string}
 *          op Operation code for the request.
 * @param {object}
 *          data Parameter map to send for the request.
 * @param {?function(jqXHR,textStatus,errorThrown)}
 *          [opt_errback] Optional error callback.
 */
cah.ajax.lib.prototype.request = function(op, data, opt_errback) {
  data.op = op;
  data.serial = this.serial++;
  var jqXHR = $.ajax({
    data : data
  });
  this.pendingRequests[data.serial] = data;
  cah.log.debug("ajax req", data);
  if (opt_errback) {
    jqXHR.fail(opt_errback);
  }
};

cah.ajax.lib.prototype.error = function(jqXHR, textStatus, errorThrown) {
  // TODO deal with this somehow
  // and figure out which request it was so we can remove it from pending
  debugger;
  cah.log.error(textStatus);
};

cah.ajax.lib.prototype.done = function(data) {
  cah.log.debug("ajax done", data);
  if (data['error']) {
    // TODO cancel any timers or whatever we may have, and disable interface
    var req = this.pendingRequests[data.serial];
    if (req && cah.ajax.ErrorHandlers[req.op]) {
      cah.ajax.ErrorHandlers[req.op](data);
    } else {
      cah.log.error(data.error_message);
    }
  } else {
    var req = this.pendingRequests[data.serial];
    if (req && cah.ajax.SuccessHandlers[req.op]) {
      cah.ajax.SuccessHandlers[req.op](data);
    } else if (req) {
      cah.log.error("Unhandled response for op " + req.op);
    } else {
      cah.log.error("Response for unknown serial " + data.serial);
    }
  }

  if (data.serial >= 0 && this.pendingRequests[data.serial]) {
    delete this.pendingRequests[data.serial];
  }
};