<?php
/**
 * Pimf_Controller
 *
 * PHP Version 5
 *
 * LICENSE
 *
 * This source file is subject to the new BSD license that is bundled
 * with this package in the file LICENSE.
 * It is also available through the world-wide-web at this URL:
 * http://krsteski.de/new-bsd-license/
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to hide@address.com so we can send you a copy immediately.
 *
 * @copyright Copyright (c) 2010-2011 Gjero Krsteski (http://krsteski.de)
 * @license http://krsteski.de/new-bsd-license New BSD License
 */

/**
 * Defines the general controller behaviour - you have to extend it.
 *
 * @package Pimf_Controller
 * @author Gjero Krsteski <hide@address.com>
 */
abstract class Pimf_Controller_Abstract
{
  /**
   * @var Pimf_Request
   */
  protected $request;

  /**
   * @var string
   */
  protected $action;

  /**
   * @param Pimf_Request $request
   */
  public function __construct(Pimf_Request $request)
  {
    $this->request = $request;
    $this->action  = $request->fromGet()->getParam('action') ?: 'index';
  }

  abstract public function indexAction();

  /**
   * Method to show the content.
   * @return mixed
   * @throws Pimf_Controller_Exception
   */
  public function render()
  {
    $suffix = Pimf_Environment::isCli() ? 'CliAction' : 'Action';
    $action = strtolower($this->action) . $suffix;

    if (method_exists($this, 'init')) {
      call_user_func(array($this, 'init'));
    }

    if (!method_exists($this, $action)) {
      throw new Pimf_Controller_Exception(
        "no action '{$action}' defined at controller ". get_class($this)
      );
    }

    return call_user_func(array($this, $action));
  }
}