Clean-up for MKWS-352 work.
[mkws-moved-to-github.git] / src / mkws-team.js
index 25a24d6..c26d2c3 100644 (file)
@@ -8,7 +8,10 @@
 // limitCategory(), delimitTarget(), delimitQuery(), showPage(),
 // pagerPrev(), pagerNext().
 //
-function team($, teamName) {
+// Before the team can be used for searching and related operations,
+// its pz2 object must be created by calling team.makePz2().
+//
+mkws.makeTeam = function($, teamName) {
   var that = {};
   var m_teamName = teamName;
   var m_submitted = false;
@@ -28,9 +31,11 @@ function team($, teamName) {
   var m_paz; // will be initialised below
   var m_templateText = {}; // widgets can register templates to be compiled
   var m_template = {}; // compiled templates, from any source
-  var m_config = mkws.objectInheritingFrom(mkws.config);
   var m_widgets = {}; // Maps widget-type to array of widget objects
   var m_gotRecords = false;
+  
+  var config = mkws.objectInheritingFrom(mkws.config);
+  that.config = config;
 
   that.toString = function() { return '[Team ' + teamName + ']'; };
 
@@ -39,12 +44,13 @@ function team($, teamName) {
   that.submitted = function() { return m_submitted; };
   that.sortOrder = function() { return m_sortOrder; };
   that.perpage = function() { return m_perpage; };
+  that.query = function() { return m_query; };
   that.totalRecordCount = function() { return m_totalRecordCount; };
   that.currentPage = function() { return m_currentPage; };
   that.currentRecordId = function() { return m_currentRecordId; };
   that.currentRecordData = function() { return m_currentRecordData; };
   that.filters = function() { return m_filterSet; };
-  that.config = function() { return m_config; };
+  that.gotRecords = function() { return m_gotRecords; };
 
   // Accessor methods for individual widgets: writers
   that.set_sortOrder = function(val) { m_sortOrder = val };
@@ -58,63 +64,51 @@ function team($, teamName) {
   //    team.queue("eventName").subscribe(function(param1, param2 ...) { ... });
   //    team.queue("eventName").publish(arg1, arg2, ...);
   //
-  var queues = {};
+  var m_queues = {};
   function queue(id) {
-    if (!queues[id]) {
+    if (!m_queues[id]) {
       var callbacks = $.Callbacks();
-      queues[id] = {
+      m_queues[id] = {
         publish: callbacks.fire,
         subscribe: callbacks.add,
         unsubscribe: callbacks.remove
       };
     }
-    return queues[id];
+    return m_queues[id];
   };
   that.queue = queue;
 
 
-  function log(s) {
+  function _log(fn, s) {
     var now = $.now();
     var timestamp = (((now - m_logTime.start)/1000).toFixed(3) + " (+" +
                      ((now - m_logTime.last)/1000).toFixed(3) + ") ");
     m_logTime.last = now;
-    mkws.log(m_teamName + ": " + timestamp + s);
+    fn.call(mkws.log, m_teamName + ": " + timestamp + s);
     that.queue("log").publish(m_teamName, timestamp, s);
   }
-  that.log = log;
-
 
-  log("making new widget team");
+  that.trace = function(x) { _log(mkws.trace, x) };
+  that.debug = function(x) { _log(mkws.debug, x) };
+  that.info = function(x) { _log(mkws.info, x) };
+  that.warn = function(x) { _log(mkws.warn, x) };
+  that.error = function(x) { _log(mkws.error, x) };
+  that.fatal = function(x) { _log(mkws.fatal, x) };
 
-  m_sortOrder = m_config.sort_default;
-  m_perpage = m_config.perpage_default;
-
-  // create a parameters array and pass it to the pz2's constructor
-  // then register the form submit event with the pz2.search function
-  // autoInit is set to true on default
-  m_paz = new pz2({ "windowid": teamName,
-                    "pazpar2path": m_config.pazpar2_url,
-                    "usesessions" : m_config.use_service_proxy ? false : true,
-                    "oninit": onInit,
-                    "onbytarget": onBytarget,
-                    "onstat": onStat,
-                    "onterm": (m_config.facets.length ? onTerm : undefined),
-                    "onshow": onShow,
-                    "onrecord": onRecord,
-                    "showtime": 500,            //each timer (show, stat, term, bytarget) can be specified this way
-                    "termlist": m_config.facets.join(',')
-                  });
-  log("created main pz2 object");
+  that.info("making new widget team");
 
+  m_sortOrder = config.sort_default;
+  m_perpage = config.perpage_default;
   // pz2.js event handlers:
   function onInit() {
-    log("init");
+    that.info("init");
     m_paz.stat();
     m_paz.bytarget();
   }
 
   function onBytarget(data) {
-    log("bytarget");
+    that.info("bytarget");
     queue("targets").publish(data);
   }
 
@@ -126,28 +120,29 @@ function team($, teamName) {
       queue("firstrecords").publish(hitcount);
     }
     if (parseInt(data.activeclients[0], 10) === 0) {
-      log("complete");
+      that.info("complete");
       queue("complete").publish(hitcount);
     }
   }
 
   function onTerm(data) {
-    log("term");
-    queue("termlists").publish(data);
+    that.info("term");
+    queue("facets").publish(data);
   }
 
   function onShow(data, teamName) {
-    log("show");
+    that.info("show");
     m_totalRecordCount = data.merged;
-    log("found " + m_totalRecordCount + " records");
+    that.info("found " + m_totalRecordCount + " records");
     queue("pager").publish(data);
     queue("records").publish(data);
   }
 
   function onRecord(data, args, teamName) {
-    log("record");
+    that.info("record");
     // FIXME: record is async!!
     clearTimeout(m_paz.recordTimer);
+    queue("record").publish(data);
     var detRecordDiv = findnode(recordDetailsId(data.recid[0]));
     if (detRecordDiv.length) {
       // in case on_show was faster to redraw element
@@ -160,15 +155,54 @@ function team($, teamName) {
   }
 
 
+  // create a parameters array and pass it to the pz2's constructor
+  // then register the form submit event with the pz2.search function
+  // autoInit is set to true on default
+  that.makePz2 = function() {
+    that.debug("m_queues=" + $.toJSON(m_queues));
+    var params = {
+      "windowid": teamName,
+      "pazpar2path": mkws.pazpar2_url(),
+      "usesessions" : config.use_service_proxy ? false : true,
+      "showtime": 500,            //each timer (show, stat, term, bytarget) can be specified this way
+      "termlist": config.facets.join(',')
+    };
+
+    params.oninit = onInit;
+    if (m_queues.targets) {
+      params.onbytarget = onBytarget;
+      that.info("setting bytarget callback");
+    }
+    if (m_queues.stat || m_queues.firstrecords || m_queues.complete) {
+      params.onstat = onStat;
+      that.info("setting stat callback");
+    }
+    if (m_queues.facets && config.facets.length) {
+      params.onterm = onTerm;
+      that.info("setting term callback");
+    }
+    if (m_queues.records) {
+      that.info("setting show callback");
+      params.onshow = onShow;
+      // Record callback is subscribed from records callback
+      that.info("setting record callback");
+      params.onrecord = onRecord;
+    }
+
+    m_paz = new pz2(params);
+    that.info("created main pz2 object");
+  }
+
+
   // Used by the Records widget and onRecord()
   function recordElementId(s) {
-    return 'mkwsRec_' + s.replace(/[^a-z0-9]/ig, '_');
+    return 'mkws-rec_' + s.replace(/[^a-z0-9]/ig, '_');
   }
   that.recordElementId = recordElementId;
 
   // Used by onRecord(), showDetails() and renderDetails()
   function recordDetailsId(s) {
-    return 'mkwsDet_' + s.replace(/[^a-z0-9]/ig, '_');
+    return 'mkws-det_' + s.replace(/[^a-z0-9]/ig, '_');
   }
 
 
@@ -178,7 +212,7 @@ function team($, teamName) {
 
 
   that.limitTarget = function(id, name) {
-    log("limitTarget(id=" + id + ", name=" + name + ")");
+    that.info("limitTarget(id=" + id + ", name=" + name + ")");
     m_filterSet.add(targetFilter(id, name));
     if (m_query) triggerSearch();
     return false;
@@ -186,7 +220,7 @@ function team($, teamName) {
 
 
   that.limitQuery = function(field, value) {
-    log("limitQuery(field=" + field + ", value=" + value + ")");
+    that.info("limitQuery(field=" + field + ", value=" + value + ")");
     m_filterSet.add(fieldFilter(field, value));
     if (m_query) triggerSearch();
     return false;
@@ -194,7 +228,7 @@ function team($, teamName) {
 
 
   that.limitCategory = function(id) {
-    log("limitCategory(id=" + id + ")");
+    that.info("limitCategory(id=" + id + ")");
     // Only one category filter at a time
     m_filterSet.removeMatching(function(f) { return f.type === 'category' });
     if (id !== '') m_filterSet.add(categoryFilter(id));
@@ -204,7 +238,7 @@ function team($, teamName) {
 
 
   that.delimitTarget = function(id) {
-    log("delimitTarget(id=" + id + ")");
+    that.info("delimitTarget(id=" + id + ")");
     m_filterSet.removeMatching(function(f) { return f.type === 'target' });
     if (m_query) triggerSearch();
     return false;
@@ -212,7 +246,7 @@ function team($, teamName) {
 
 
   that.delimitQuery = function(field, value) {
-    log("delimitQuery(field=" + field + ", value=" + value + ")");
+    that.info("delimitQuery(field=" + field + ", value=" + value + ")");
     m_filterSet.removeMatching(function(f) { return f.type == 'field' &&
                                              field == f.field && value == f.value });
     if (m_query) triggerSearch();
@@ -255,9 +289,9 @@ function team($, teamName) {
 
 
   function newSearch(query, sortOrder, maxrecs, perpage, limit, targets, torusquery) {
-    log("newSearch: " + query);
+    that.info("newSearch: " + query);
 
-    if (m_config.use_service_proxy && !mkws.authenticated) {
+    if (config.use_service_proxy && !mkws.authenticated) {
       alert("searching before authentication");
       return;
     }
@@ -272,7 +306,6 @@ function team($, teamName) {
 
   function triggerSearch(query, sortOrder, maxrecs, perpage, limit, targets, torusquery) {
     resetPage();
-    queue("navi").publish();
 
     // Continue to use previous query/sort-order unless new ones are specified
     if (query) m_query = query;
@@ -292,23 +325,30 @@ function team($, teamName) {
     if (maxrecs) params.maxrecs = maxrecs;
     if (torusquery) {
       if (!mkws.config.use_service_proxy)
-        alert("can't narrow search by torusquery when Service Proxy is not in use");
+        alert("can't narrow search by torusquery when not authenticated");
       params.torusquery = torusquery;
     }
 
-    log("triggerSearch(" + m_query + "): filters = " + m_filterSet.toJSON() + ", " +
+    that.info("triggerSearch(" + m_query + "): filters = " + m_filterSet.toJSON() + ", " +
         "pp2filter = " + pp2filter + ", params = " + $.toJSON(params));
 
     m_paz.search(m_query, m_perpage, m_sortOrder, pp2filter, undefined, params);
+    queue("searchtriggered").publish();
   }
 
+  // fetch record details to be retrieved from the record queue
+  that.fetchDetails = function(recId) {
+    that.info("fetchDetails() requesting record '" + recId + "'");
+    m_paz.record(recId);
+  };
+
 
   // switching view between targets and records
   function switchView(view) {
-    var targets = widgetNode('Targets');
-    var results = widgetNode('Results') || widgetNode('Records');
-    var blanket = widgetNode('Blanket');
-    var motd    = widgetNode('MOTD');
+    var targets = widgetNode('targets');
+    var results = widgetNode('results') || widgetNode('records');
+    var blanket = widgetNode('blanket');
+    var motd    = widgetNode('motd');
 
     switch(view) {
     case 'targets':
@@ -345,7 +385,7 @@ function team($, teamName) {
       return;
     }
     // request the record
-    log("showDetails() requesting record '" + recId + "'");
+    that.info("showDetails() requesting record '" + recId + "'");
     m_paz.record(recId);
   };
 
@@ -355,14 +395,14 @@ function team($, teamName) {
     teamName = teamName || m_teamName;
 
     if (teamName === 'AUTO') {
-      selector = (selector + '.mkwsTeam_' + teamName + ',' +
-                  selector + ':not([class^="mkwsTeam"],[class*=" mkwsTeam"])');
+      selector = (selector + '.mkws-team-' + teamName + ',' +
+                  selector + ':not([class^="mkws-team"],[class*=" mkws-team"])');
     } else {
-      selector = selector + '.mkwsTeam_' + teamName;
+      selector = selector + '.mkws-team-' + teamName;
     }
 
     var node = $(selector);
-    //log('findnode(' + selector + ') found ' + node.length + ' nodes');
+    //that.debug('findnode(' + selector + ') found ' + node.length + ' nodes');
     return node;
   }
 
@@ -373,46 +413,58 @@ function team($, teamName) {
   }
 
   function renderDetails(data, marker) {
-    var template = loadTemplate("Record");
+    var template = loadTemplate("details");
     var details = template(data);
-    return '<div class="mkwsDetails mkwsTeam_' + m_teamName + '" ' +
+    return '<div class="mkws-details mkwsDetails mkwsTeam_' + m_teamName + '" ' +
       'id="' + recordDetailsId(data.recid[0]) + '">' + details + '</div>';
   }
   that.renderDetails = renderDetails;
 
 
   that.registerTemplate = function(name, text) {
+    if(mkws._old2new.hasOwnProperty(name)) {
+      that.warn("registerTemplate: old widget name: " + name + " => " + mkws._old2new[name]);
+      name = mkws._old2new[name];
+    }
     m_templateText[name] = text;
   };
 
 
-  function loadTemplate(name) {
-    var template = m_template[name];
+  function loadTemplate(name, fallbackString) {
+    if(mkws._old2new.hasOwnProperty(name)) {
+       that.warn("loadTemplate: old widget name: " + name + " => " + mkws._old2new[name]);
+       name = mkws._old2new[name];
+    }
 
-    if (template === undefined) {
-      // Fall back to generic template if there is no team-specific one
+    var template = m_template[name];
+    if (template === undefined && Handlebars.compile) {
       var source;
-      var node = $(".mkwsTemplate_" + name + " .mkwsTeam_" + that.name());
+      var node = $(".mkws-template-" + name + " .mkws-team-" + that.name());
       if (node && node.length < 1) {
-        node = $(".mkwsTemplate_" + name);
-      }
-      if (node) {
-        source = node.html();
-      }
-
-      if (!source) {
-        source = m_templateText[name];
+        node = $(".mkws-template-" + name);
       }
-      if (!source) {
-        source = mkws.defaultTemplate(name);
+      if (node) source = node.html();
+      if (!source) source = m_templateText[name];
+      if (source) {
+        template = Handlebars.compile(source);
+        that.info("compiled template '" + name + "'");
       }
-
-      template = Handlebars.compile(source);
-      log("compiled template '" + name + "'");
+    }
+    //if (template === undefined) template = mkws_templatesbyteam[m_teamName][name];
+    if (template === undefined && Handlebars.templates) {
+      template = Handlebars.templates["mkws-template-" + name];
+    }
+    if (template === undefined && mkws.defaultTemplates) {
+      template = mkws.defaultTemplates[name];
+    }
+    if (template) {
       m_template[name] = template;
+      return template;
     }
-
-    return template;
+    else {
+      that.info("No MKWS template for " + name);
+      return null;
+    }  
   }
   that.loadTemplate = loadTemplate;
 
@@ -447,8 +499,7 @@ function team($, teamName) {
       }
     }
     return undefined;
-  }
-
+  };
 
   return that;
 };