pad.pub0.org/node/db/AuthorManager.js

/**
 * The AuthorManager controlls all information about the Pad authors
 */

/*
 * 2011 Peter 'Pita' Martischka
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS-IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

var db = require("./DB").db;
var async = require("async");

/**
 * Returns the Author Id for a token. If the token is unkown, 
 * it creates a author for the token
 * @param {String} token The token 
 * @param {Function} callback callback (err, author) 
 * The callback function that is called when the result is here 
 */
exports.getAuthor4Token = function (token, callback)
{  
  var author;
  
  async.series([
    //try to get the author for this token
    function(callback)
    {
      db.get("token2author:" + token, function (err, _author)
      {
        author = _author;
        callback(err);
      });
    },
    function(callback)
    {
      //there is no author with this token, so create one
      if(author == null)
      {
        createAuthor(token, function(err, _author)
        {
          author = _author;
          callback(err);
        });
      }
      //there is a author with this token
      else
      {
        //check if there is also an author object for this token, if not, create one
        db.get("globalAuthor:" + author, function(err, authorObject)
        {
          if(authorObject == null)
          {
            createAuthor(token, function(err, _author)
            {
              author = _author;
              callback(err);
            });
          }
          //the author exists, update the timestamp of this author
          else
          {
            db.setSub("globalAuthor:" + author, ["timestamp"], new Date().getTime());
            callback();
          }
        });
      }
    }
  ], function(err)
  {
    callback(err, author);
  });
}

/**
 * Internal function that creates the database entry for an author 
 * @param {String} token The token 
 */
function createAuthor (token, callback)
{
  //create the new author name
  var author = "g." + _randomString(16);
        
  //create the globalAuthors db entry
  var authorObj = {colorId : Math.floor(Math.random()*32), name: null, timestamp: new Date().getTime()};
        
  //we do this in series to ensure this db entries are written in the correct order
  async.series([
    //set the global author db entry
    function(callback)
    {
      db.set("globalAuthor:" + author, authorObj, callback); 
    },
    //set the token2author db entry
    function(callback)
    {
      db.set("token2author:" + token, author, callback);
    }
  ], function(err)
  {
    callback(err, author);
  });
}

/**
 * Returns the Author Obj of the author
 * @param {String} author The id of the author
 * @param {Function} callback callback(err, authorObj)
 */
exports.getAuthor = function (author, callback)
{
  db.get("globalAuthor:" + author, callback);
}

/**
 * Returns the color Id of the author
 * @param {String} author The id of the author
 * @param {Function} callback callback(err, colorId)
 */
exports.getAuthorColorId = function (author, callback)
{
  db.getSub("globalAuthor:" + author, ["colorId"], callback);
}

/**
 * Sets the color Id of the author
 * @param {String} author The id of the author
 * @param {Function} callback (optional)
 */
exports.setAuthorColorId = function (author, colorId, callback)
{
  db.setSub("globalAuthor:" + author, ["colorId"], colorId, callback);
}

/**
 * Returns the name of the author
 * @param {String} author The id of the author
 * @param {Function} callback callback(err, name)
 */
exports.getAuthorName = function (author, callback)
{
  db.getSub("globalAuthor:" + author, ["name"], callback);
}

/**
 * Sets the name of the author
 * @param {String} author The id of the author
 * @param {Function} callback (optional)
 */
exports.setAuthorName = function (author, name, callback)
{
  db.setSub("globalAuthor:" + author, ["name"], name, callback);
}

/**
 * Generates a random String with the given length. Is needed to generate the Author Ids
 */
function _randomString(len) {
  // use only numbers and lowercase letters
  var pieces = [];
  for(var i=0;i<len;i++) {
    pieces.push(Math.floor(Math.random()*36).toString(36).slice(-1));
  }
  return pieces.join('');
}