Service.php

<?php

namespace Pomm;

use Pomm\Connection\Database;
use Pomm\Exception\Exception;

/**
 * Service
 * This is the service for the Pomm API.
 *
 * @package Pomm
 * @version $id$
 * @copyright 2011 Grégoire HUBERT
 * @author Grégoire HUBERT <hubert.greg@gmail.com>
 * @license X11 {@link http://opensource.org/licenses/mit-license.php}
 */
class Service
{

    protected $databases = array();


    /**
     * __construct
     * Set the databases with parameters
     *
     * @access public
     * @param Array $databases parameters
     * @return void
     */

    public function __construct(Array $databases = array())
    {
        foreach ($databases as $name => $parameters)
        {
            $db_class = isset($parameters['class']) ? $parameters['class'] : 'Pomm\Connection\Database';
            $this->setDatabase($name, new $db_class($parameters));
        }
    }

    /**
     * setDatabase
     * save a Database
     *
     * @access public
     * @param String $name the database name
     * @param Database $database the database instance
     * @return void
     */

    public function setDatabase($name, Database $database)
    {
        $this->databases[$name] = $database;
    }

    /**
     * getDatabase
     * Returns the corresponding Database or the first one if no name is provided
     *
     * @param mixed $name
     * @access public
     * @return Database
     */
    public function getDatabase($name = null)
    {
        if (is_null($name))
        {
            if (count($this->databases) == 0)
            {
                throw new Exception(sprintf('No database registered.'));
            }

            return reset($this->databases);
        }
        if (array_key_exists($name, $this->databases))
        {
            return $this->databases[$name];
        }

        throw new Exception(sprintf('No database with this name "%s".', $name));
    }

    /**
     * createConnection
     * Shortcut to get a connection from a database. 
     *
     * @param string the database name
     * @return \Pomm\Connection\Connection
     */
    public function createConnection($name = null)
    {
        return $this->getDatabase($name)->getConnection();
    }
}