A Follow-up on the Zend Framework Quickstart Tutorial: The Model

CREATE TABLE  `test_databases`.`group` (
    `id` INT NOT NULL AUTO_INCREMENT ,
    `name` VARCHAR( 100 ) NOT NULL ,
    `description_text` VARCHAR( 255 ) NOT NULL ,
    PRIMARY KEY (  `id` )
)

class Default_Model_Group 
{
    protected $_id; //a field
    protected $_name; //a field
    protected $_description_text; //a field
    protected $_mapper; //the mapper
 
    public function __construct(array $options = null)
    {
        if (is_array($options)) {
            $this->setOptions($options);
        }
    }
 
    //__set() and __get() are built-in in PHP
    //they are called Magic Methods
    //http://us2.php.net/manual/en/language.oop5.magic.php
    public function __set($name, $value)
    {
        //Section A
        //What we are trying to do here is remove the underscores and camelCase the $name
        //so that we can call the $name as a Method within our class
        $pieces = explode('_', $name);
        foreach($pieces AS $key => $row) {
            $pieces[$key] = ucfirst($row);
        }
 
        //Section B
        //so $method below would contain:
        //$method = 'setDescriptionText' when you $obj->description_text = 'My Desc...'
        //we will look into this more in the following paragraphs...
        $name = implode('',$pieces);
        $method = 'get' . $name;
        if (('mapper' == $name) || !method_exists($this, $method)) {
            throw new Exception('Invalid group property');
        }
 
        //Section C
        //The code below will call the ff:
        //$this->setDescriptionText($value);
        //because $method is equal to "setDescriptionText".
        //setDescriptionText was created in Section A of this code snippet
        $this->$method($value);
    }
 
    //__get has the same idea as __set
    public function __get($name)
    {
        //again, we strip the underscores and camelCase
        $pieces = explode('_', $name);
        foreach($pieces AS $key => $row) {
            $pieces[$key] = ucfirst($row);
        }
        $name = implode('',$pieces);
        $method = 'get' . $name;
        if (('mapper' == $name) || !method_exists($this, $method)) {
            throw new Exception('Invalid group property');
        }
        //then we call the method...
        //For example: $this->getDescriptionText()
        return $this->$method();
    }
 
    public function setOptions(array $options)
    {
        $methods = get_class_methods($this);
        foreach ($options as $key => $value) {
            $method = 'set' . ucfirst($key);
            if (in_array($method, $methods)) {
                $this->$method($value);
            }
        }
        return $this;
    }
 
    public function setName($text)
    {
        $this->_name = (string) $text;
        return $this;
    }
 
    public function getDescriptionText()
    {
        return $this->_description_text;
    }
 
    public function setDescriptionText($text)
    {
        $this->_description_text = (string) $text;
        return $this;
    }
 
    public function getName()
    {
        return $this->_name;
    }
 
    public function setId($id)
    {
        $this->_twitter_id = (int) $id;
        return $this;
    }
 
    public function getId()
    {
        return $this->_id;
    }
 
    {
        $this->_mapper = $mapper;
        return $this;
    }
 
    public function getMapper()
    {
        if (null === $this->_mapper) {
            $this->setMapper(new Default_Model_GroupMapper());
        }
        return $this->_mapper;
    }
 
    public function save()
    {
        $this->getMapper()->save($this);
    }
 
    public function find($id)
    {
        $this->getMapper()->find($id, $this);
        return $this;
    }
 
    public function fetchAll()
    {
        return $this->getMapper()->fetchAll();
    }
 
    public function fetchGroup($id)
    {
        return $this->getMapper()->fetchGroup($id);
    }
}

<?php
 
class Default_Model_GroupMapper
{
    protected $_dbTable;
 
    public function setDbTable($dbTable)
    {
        if (is_string($dbTable)) {
            $dbTable = new $dbTable();
        }
        if (!$dbTable instanceof Zend_Db_Table_Abstract) {
            throw new Exception('Invalid table data gateway provided');
        }
        $this->_dbTable = $dbTable;
        return $this;
    }
 
    public function getDbTable()
    {
        if (null === $this->_dbTable) {
            $this->setDbTable('Default_Model_DbTable_Group');
        }
        return $this->_dbTable;
    }
 
    public function save(Default_Model_Group $obj)
    {
        $data = array(
            'name'   => $obj->getName(),
            'description_text' => $obj->getDescriptionText()
        );
 
        if (null === ($id = $obj->getId())) {
            unset($data['id']);
            $this->getDbTable()->insert($data);
        } else {
            $this->getDbTable()->update($data, array('id = ?' => $id));
        }
    }
 
    public function find($id, Default_Model_Group $obj)
    {
        $result = $this->getDbTable()->find($id);
        if (0 == count($result)) {
            return;
        }
        $row = $result->current();
        $twitter->setId($row->id)
                  ->setName($row->name)
                  ->setDescriptionText($row->description_text);
    }
 
    public function fetchAll()
    {
        $resultSet = $this->getDbTable()->fetchAll();
        $entries   = array();
        foreach ($resultSet as $row) {
            $entry = new Default_Model_Group();
            $entry->setId($row->id)
                  ->setName($row->name)
                  ->setDescriptionText($row->description_text);
                  ->setMapper($this);
            $entries[] = $entry;
        }
        return $entries;
    }
 
    public function fetchGroup($id)
    {
        $quoted = $this->getDbTable()->getAdapter()->quote($id,'INTEGER');
        $resultSet = $this->getDbTable()->fetchAll('id = '.$quoted);
        return $resultSet;
    }
}

<?php
 
class Twitter_Model_DbTable_Group extends Zend_Db_Table_Abstract 
{
    protected $_name = 'group';
}

<?php
 
class GroupController extends Zend_Controller_Action
{
    protected $_flashMessenger = null;
 
    public function init()
    {
        /* Initialize action controller here */
        $this->_flash_messenger = $this->_helper->FlashMessenger;
    }
 
    public function indexAction()
    {
        // action body
    }
 
    public function saveAction()
    {
        $this->_helper->viewRenderer->setNoRender();
        $this->_helper->layout()->disableLayout();
 
        $group_name = $this->getRequest()->getPost('group_name');
        $group_desc = $this->getRequest()->getPost('group_desc');
 
        $group_model = new Default_Model_Group();
        $group_model->name= $group_name; //this is what I have been trying to tell from Section A above
        $group_model->description_text= $group_desc; //and this too!!!
        $group_model->save();
 
        $this->_flash_messenger->addMessage('You have added group: <b>'.$group_name.'</b>');
        $this->_redirect('/group'); 
    }
}