/**
  *
  * @param int $userId
  * @param string $description (='') - the description of the use
  * @return boolean - false is the user has got a personal api key already, true otherwise
  */
 public static function createPersonalApiApp($userId, $description = '')
 {
     $alreadyExisting = is_object(self::retrieveByUserId($userId));
     if ($alreadyExisting) {
         return false;
     }
     $apiKey = '';
     $safetyCounter = 0;
     // to avoid infinite loop under any circumstances
     do {
         $apiKey = PcUtils::generate40CharacterRandomHash();
         $c = new Criteria();
         $c->add(PcApiAppPeer::API_KEY, $apiKey);
         $alreadyExisting = PcApiAppPeer::doSelectOne($c);
         $safetyCounter++;
         if ($safetyCounter == 100) {
             throw new Exception("Detected possible infinite loop while creating API key");
         }
     } while (is_object($alreadyExisting));
     $personalApiApp = new PcApiApp();
     $personalApiApp->setUserId($userId)->setName('personal')->setApiKey($apiKey)->setApiSecret(PcUtils::generateRandomString(16))->setIsLimited(true)->setDescription($description)->save();
     $apiKeyStats = new PcApiAppStats();
     $apiKeyStats->setApiAppId($personalApiApp->getId())->setToday(date('Y-m-d'))->setLastHour(date('H'))->save();
     $userKey = PcUserKeyPeer::retrieveByPK($userId);
     if (!is_object($userKey)) {
         $userKey = new PcUserKey();
         $userKey->setUserId($userId)->setKey(PcUtils::generate32CharacterRandomHash())->save();
     }
     return true;
 }
 /**
  * If $apiKey is not null, it has the priority over getting the api secret
  * from the token
  *
  * @param string $token - must be a valid token
  * @param string $apiKey (=null)
  * @return null|PcApiApp - null is the API key does not exist
  */
 private function getApiApp($token, $apiKey = null)
 {
     if (null !== $apiKey) {
         $apiAppEntry = PcApiAppPeer::retrieveByApiKey($apiKey);
         if (null === $apiAppEntry) {
             return null;
         }
         return $apiAppEntry;
     }
     $c = new Criteria();
     $c->addJoin(PcApiAppPeer::ID, PcApiTokenPeer::API_APP_ID);
     $c->add(PcApiTokenPeer::TOKEN, $token);
     $apiAppEntry = PcApiAppPeer::doSelectOne($c);
     if (!is_object($apiAppEntry)) {
         return null;
     }
     return $apiAppEntry;
 }