[Solar-svn] Revision 2659

[pmjones at solarphp.com]

Branch: Solar_Sql_Result: [DEL] Removed deprecated class



Deleted: branches/orm/Solar/Sql/Result.php
===================================================================
--- branches/orm/Solar/Sql/Result.php	2007-08-06 15:49:59 UTC (rev 2658)
+++ branches/orm/Solar/Sql/Result.php	2007-08-06 15:50:24 UTC (rev 2659)
@@ -1,224 +0,0 @@
-<?php
-/**
- * 
- * Class for iterating through selected row results.
- * 
- * @category Solar
- * 
- * @package Solar_Sql
- * 
- * @author Paul M. Jones <pmjones at solarphp.com>
- * 
- * @license http://opensource.org/licenses/bsd-license.php BSD
- * 
- * @version $Id$
- * 
- */
-
-/**
- * 
- * Class for iterating through selected row results.
- * 
- * @category Solar
- * 
- * @package Solar_Sql
- * 
- * @deprecated
- * 
- */
-class Solar_Sql_Result extends Solar_Base implements Iterator {
-    
-    /**
-     * 
-     * User-defined configuration keys.
-     * 
-     * Keys are ...
-     * 
-     * `PDOStatement`
-     * : (object) A PDOStatement object to be used as the
-     *   result source.
-     * 
-     * @var array
-     * 
-     */
-    protected $_Solar_Sql_Result = array(
-        'PDOStatement' => null,
-    );
-    
-    /**
-     * 
-     * Collection of rows fetched from the result source.
-     * 
-     * @var array
-     * 
-     */
-    protected $_rows = array();
-    
-    /**
-     * 
-     * Pointer to the current iteration.
-     * 
-     * @var int
-     * 
-     */
-    protected $_curr = null;
-    
-    /**
-     * 
-     * Have we filled Solar_Sql_Result::$_rows with all results?
-     * 
-     * @var bool
-     * 
-     */
-    protected $_full = false;
-    
-    /**
-     * 
-     * Constructor.
-     * 
-     * @param array $config User-defined configuration.
-     * 
-     */
-    public function __construct($config = null)
-    {
-        parent::__construct($config);
-        if (! ($this->_config['PDOStatement'] instanceof PDOStatement)) {
-            throw $this->_exception('ERR_NOT_PDOSTATEMENT');
-        }
-    }
-    
-    /**
-     * 
-     * Rewinds the iterator back to the beginning.
-     * 
-     * @return void
-     * 
-     */
-    public function rewind()
-    {
-        $this->_curr = 0;
-    }
-    
-    /**
-     * 
-     * Returns the current iterator key.
-     * 
-     * @return int The current iterator key.
-     * 
-     */
-    public function key()
-    {
-        return $this->_curr;
-    }
-    
-    /**
-     * 
-     * Increments the iterator key.
-     * 
-     * @return int The incremented iterator key.
-     * 
-     */
-    public function next()
-    {
-        // increment the counter
-        $this->_curr += 1;
-        
-        // populate the row
-        $this->_fetch();
-        
-        // return the incremented value
-        return $this->_curr;
-    }
-    
-    /**
-     * 
-     * Determines if the current iterator key is valid.
-     * 
-     * Also populates the current row from the result source.
-     * 
-     * @return bool True if valid, false if not.
-     * 
-     */
-    public function valid()
-    {
-        // do we already have a row in the current position?
-        if (! empty($this->_rows[$this->_curr])) {
-            return true;
-        } else {
-            // populate the current position
-            return $this->_fetch();
-        }
-    }
-    
-    /**
-     * 
-     * Returns the current row for the iterator.
-     * 
-     * @return mixed The current row element.
-     * 
-     */
-    public function current()
-    {
-        return $this->_rows[$this->_curr];
-    }
-    
-    /**
-     * 
-     * Returns the next row from the result source.
-     * 
-     * @return mixed Boolean false if there is no
-     * next row, or the next row element.
-     * 
-     */
-    public function fetch()
-    {
-        if ($this->valid()) {
-            $row = $this->_rows[$this->_curr];
-            $this->next();
-            return $row;
-        } else {
-            return false;
-        }
-    }
-    
-    /**
-     * 
-     * Returns all rows from the result source.
-     * 
-     * @return array An array of row elements.
-     * 
-     */
-    public function fetchAll()
-    {
-        if (! $this->_full) {
-            // populate all of $_rows
-            foreach ($this as $val) {}
-        }
-        
-        // return them all
-        return $this->_rows;
-    }
-    
-    /**
-     * 
-     * Support method to populate Solar_Sql_Result::$_rows from the result source.
-     * 
-     * @return bool True if a row was populated, false if not.
-     * 
-     */
-    protected function _fetch()
-    {
-        // is there a next row?
-        $data = $this->_config['PDOStatement']->fetch(PDO::FETCH_ASSOC);
-        if (! $data) {
-            // no new rows, which means the $_rows array
-            // must be fully populated.
-            $this->_full = true;
-            return false;
-        }
-        
-        // found a row, retain it internally
-        $this->_rows[$this->_curr] = $data;
-        return true;
-    }
-}