Source: extras/data.js

  1. /**
  2.  * Data manipulation related functions.
  3.  * @namespace
  4.  */
  5. Bravey.Data = {};
  7. /**
  8.  * Extract entities or context values with the same name from a {@link Bravey.ContextManager.testBySessionId} call result.
  9.  * @param {ContextManagerResultBySessionId} matchdata - The data returned by {@link Bravey.ContextManager.testBySessionId}.
  10.  * @param {string} entityname - The data returned by {@link Bravey.ContextManager.testBySessionId}.
  11.  * @param {string} [defaultvalue=undefined] - The matched entity value cosidered as "default". (i.e. if found, session data value is returned anyway)
  12.  * @returns {string} The matching value.
  13.  * @returns {undefined} If the entity name is not set in match or session.
  14.  */
  15. Bravey.Data.getEntityValue = function(matchdata, entityname, defaultvalue) {
  16.   var found;
  17.   if (matchdata) {
  18.     if ((matchdata.result !== undefined) && (matchdata.result.entitiesIndex !== undefined) && (matchdata.result.entitiesIndex[entityname] !== undefined))
  19.       found = matchdata.result.entitiesIndex[entityname].value;
  20.     if (found == defaultvalue) found = undefined;
  21.     if ((found == undefined) && (matchdata.sessionData !== undefined))
  22.       found = matchdata.sessionData[entityname];
  23.   }
  24.   return found;
  25. }
  27. /**
  28.  * Returns true if a {@link Bravey.ContextManager.testBySessionId} result contains the specified entity.
  29.  * @param {ContextManagerResultBySessionId} matchdata - The data returned by {@link Bravey.ContextManager.testBySessionId}.
  30.  * @param {string} entityname - The entity to be checked.
  31.  * @returns {true} When the entity is specified.
  32.  */
  33. Bravey.Data.isExplicit = function(matchdata, entityname) {
  34.   return (matchdata && (matchdata.result !== undefined) && (matchdata.result.entitiesIndex !== undefined) && (matchdata.result.entitiesIndex[entityname] !== undefined));
  35. }