[Summary view] [Print] [Text view]

   1  <?php
   2  
   3  /**
   4   * Zend Framework
   5   *
   6   * LICENSE
   7   *
   8   * This source file is subject to the new BSD license that is bundled
   9   * with this package in the file LICENSE.txt.
  10   * It is also available through the world-wide-web at this URL:
  11   * http://framework.zend.com/license/new-bsd
  12   * If you did not receive a copy of the license and are unable to
  13   * obtain it through the world-wide-web, please send an email
  14   * to [email protected] so we can send you a copy immediately.
  15   *
  16   * @category   Zend
  17   * @package    Zend_Gdata
  18   * @subpackage App
  19   * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
  20   * @license    http://framework.zend.com/license/new-bsd     New BSD License
  21   * @version    $Id$
  22   */
  23  
  24  /**
  25   * Utility class for static functions needed by Zend_Gdata_App
  26   *
  27   * @category   Zend
  28   * @package    Zend_Gdata
  29   * @subpackage App
  30   * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
  31   * @license    http://framework.zend.com/license/new-bsd     New BSD License
  32   */
  33  class Zend_Gdata_App_Util
  34  {
  35  
  36      /**
  37       *  Convert timestamp into RFC 3339 date string.
  38       *  2005-04-19T15:30:00
  39       *
  40       * @param int $timestamp
  41       * @throws Zend_Gdata_App_InvalidArgumentException
  42       */
  43      public static function formatTimestamp($timestamp)
  44      {
  45          $rfc3339 = '/^(\d{4})\-?(\d{2})\-?(\d{2})((T|t)(\d{2})\:?(\d{2})' .
  46                     '\:?(\d{2})(\.\d{1,})?((Z|z)|([\+\-])(\d{2})\:?(\d{2})))?$/';
  47  
  48          if (ctype_digit($timestamp)) {
  49              return gmdate('Y-m-d\TH:i:sP', $timestamp);
  50          } elseif (preg_match($rfc3339, $timestamp) > 0) {
  51              // timestamp is already properly formatted
  52              return $timestamp;
  53          } else {
  54              $ts = strtotime($timestamp);
  55              if ($ts === false) {
  56                  require_once 'Zend/Gdata/App/InvalidArgumentException.php';
  57                  throw new Zend_Gdata_App_InvalidArgumentException("Invalid timestamp: $timestamp.");
  58              }
  59              return date('Y-m-d\TH:i:s', $ts);
  60          }
  61      }
  62  
  63      /** Find the greatest key that is less than or equal to a given upper
  64        * bound, and return the value associated with that key.
  65        *
  66        * @param integer|null $maximumKey The upper bound for keys. If null, the
  67        *        maxiumum valued key will be found.
  68        * @param array $collection An two-dimensional array of key/value pairs
  69        *        to search through.
  70        * @returns mixed The value corresponding to the located key.
  71        * @throws Zend_Gdata_App_Exception Thrown if $collection is empty.
  72        */
  73      public static function findGreatestBoundedValue($maximumKey, $collection)
  74      {
  75          $found = false;
  76          $foundKey = $maximumKey;
  77  
  78          // Sanity check: Make sure that the collection isn't empty
  79          if (sizeof($collection) == 0) {
  80              require_once 'Zend/Gdata/App/Exception.php';
  81              throw new Zend_Gdata_App_Exception("Empty namespace collection encountered.");
  82          }
  83  
  84          if ($maximumKey === null) {
  85              // If the key is null, then we return the maximum available
  86              $keys = array_keys($collection);
  87              sort($keys);
  88              $found = true;
  89              $foundKey = end($keys);
  90          } else {
  91              // Otherwise, we optimistically guess that the current version
  92              // will have a matching namespce. If that fails, we decrement the
  93              // version until we find a match.
  94              while (!$found && $foundKey >= 0) {
  95                  if (array_key_exists($foundKey, $collection))
  96                      $found = true;
  97                  else
  98                      $foundKey--;
  99              }
 100          }
 101  
 102          // Guard: A namespace wasn't found. Either none were registered, or
 103          // the current protcol version is lower than the maximum namespace.
 104          if (!$found) {
 105              require_once 'Zend/Gdata/App/Exception.php';
 106              throw new Zend_Gdata_App_Exception("Namespace compatible with current protocol not found.");
 107          }
 108  
 109          return $foundKey;
 110      }
 111  
 112  }