Change the StoreFactory to work with the DbAdapterFactory and fix code styling

Change the StoreFactory configuration to reference to a resource instead of
defining the whole database. Additionally fix docstrings, fix imports and fix
function calls to comply to coding style standards.

refs #4503

config/config.ini

@@ -27,8 +27,4 @@ type=ini
 ; Use database to store preference into mysql or postgres
 ;[preferences]
 ;type=db
-;dbtype=pgsql
-;dbhost=127.0.0.1
-;dbpassword=icingaweb
-;dbuser=icingaweb
-;dbname=icingaweb
+;resource=icingaweb-mysql

doc/preferences.md

@@ -29,27 +29,12 @@ example:
 
     [preferences]
     type=db
-    dbtype=pgsql
-    dbhost=127.0.0.1
-    dbpassword=icingaweb
-    dbuser=icingaweb
-    dbname=icingaweb
+    resource=icingaweb-pgsql
 
 ### Settings
 
-* **dbtype**: Database adapter, currently supporting ***mysql*** or ***pgsql***
-
-* **dbhost**: Host of the database server, use localhost or 127.0.0.1
-for unix socket transport
-
-* **dbpassword**: Password for the configured database user
-
-* **dbuser**: User who can connect to database
-
-* **dbname**: Name of the database
-
-* **port**(optional): For network connections the specific port if not default
-(3306 for mysql and 5432 for postgres)
+* **resource**: A reference to a database declared in *resources.ini*. Please read the chapter about
+ resources for a detailed description about how to set up resources.
 
 ### Preparation
 

library/Icinga/Application/ApplicationBootstrap.php

@@ -35,7 +35,7 @@ use Icinga\Application\Modules\Manager as ModuleManager;
 use Icinga\Application\Platform;
 use \Icinga\Application\Config;
 use Icinga\Exception\ProgrammingError;
-use Icinga\Application\DbAdapterFactory;
+use \Icinga\Application\DbAdapterFactory;
 use Icinga\Exception\ConfigurationError;
 use Icinga\Util\DateTimeFactory;
 
@@ -343,9 +343,6 @@ abstract class ApplicationBootstrap
     }
 
     /**
-<<<<<<< HEAD
-     * Setup time zone
-=======
      * Setup factories that provide access to the resources
      *
      * @return self
@@ -359,7 +356,6 @@ abstract class ApplicationBootstrap
 
     /**
      * Setup default timezone
->>>>>>> Add the DbAdapterFactory to instanciate database adapters using resource names
      *
      * @return self
      * @throws ConfigurationError if the timezone in config.ini isn't valid

library/Icinga/Application/ConfigAwareFactory.php

@@ -1,42 +0,0 @@
-<?php
-// {{{ICINGA_LICENSE_HEADER}}}
-/**
- * This file is part of Icinga 2 Web.
- *
- * Icinga 2 Web - Head for multiple monitoring backends.
- * Copyright (C) 2013 Icinga Development Team
- *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the GNU General Public License
- * as published by the Free Software Foundation; either version 2
- * of the License, or (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
- *
- * @copyright 2013 Icinga Development Team <info@icinga.org>
- * @license   http://www.gnu.org/licenses/gpl-2.0.txt GPL, version 2
- * @author    Icinga Development Team <info@icinga.org>
- */
-// {{{ICINGA_LICENSE_HEADER}}}
-
-namespace Icinga\Application;
-
-/**
- * A factory that is configurable
- */
-interface ConfigAwareFactory {
-
-    /**
-     * Set the factory configuration
-     *
-     * @param mixed $config     The configuration
-     */
-    public static function setConfig($config);
-}

library/Icinga/Application/DbAdapterFactory.php

@@ -31,6 +31,7 @@ namespace Icinga\Application;
 use Zend_Config;
 use Zend_Db;
 use Icinga\Application\Logger;
+use Icinga\Util\ConfigAwareFactory;
 use Icinga\Exception\ConfigurationError;
 use Icinga\Exception\ProgrammingError;
 use Tests\Icinga\Application\ZendDbMock;
@@ -38,8 +39,8 @@ use Tests\Icinga\Application\ZendDbMock;
 /**
  * Create resources using short identifiers referring to configuration entries
  */
-class DbAdapterFactory implements ConfigAwareFactory {
-
+class DbAdapterFactory implements ConfigAwareFactory
+{
     /**
      * Resource definitions
      *
@@ -165,7 +166,8 @@ class DbAdapterFactory implements ConfigAwareFactory {
     {
         if ($config->type !== 'db') {
             throw new ConfigurationError(
-                'Resource type must be "db" but is "' . $config->type . '"');
+                'Resource type must be "db" but is "' . $config->type . '"'
+            );
         }
         $options = array(
             'dbname'    => $config->dbname,

library/Icinga/Authentication/Backend/DbUserBackend.php

@@ -29,11 +29,11 @@
 
 namespace Icinga\Authentication\Backend;
 
-use Icinga\User;
-use Icinga\Authentication\UserBackend;
-use Icinga\Authentication\Credentials;
-use Icinga\Authentication;
-use Icinga\Application\Logger;
+use \Icinga\User;
+use \Icinga\Authentication\UserBackend;
+use \Icinga\Authentication\Credentials;
+use \Icinga\Authentication;
+use \Icinga\Application\Logger;
 
 /**
  * User authentication backend (@see Icinga\Authentication\UserBackend) for
@@ -43,8 +43,8 @@ use Icinga\Application\Logger;
  * See the UserBackend class (@see Icinga\Authentication\UserBackend) for
  * usage information
  */
-class DbUserBackend implements UserBackend {
-
+class DbUserBackend implements UserBackend
+{
     /**
      * The database connection that will be used for fetching users
      *
@@ -93,6 +93,7 @@ class DbUserBackend implements UserBackend {
      * Check if the user identified by the given credentials is available
      *
      * @param Credentials $credentials The login credentials
+     *
      * @return boolean True when the username is known and currently active.
      */
     public function hasUsername(Credentials $credential)
@@ -109,6 +110,7 @@ class DbUserBackend implements UserBackend {
      * Authenticate a user with the given credentials
      *
      * @param Credentials $credentials The login credentials
+     *
      * @return User|null The authenticated user or Null.
      */
     public function authenticate(Credentials $credential)
@@ -122,7 +124,8 @@ class DbUserBackend implements UserBackend {
             ->select()->from($this->userTable)
                 ->where($this->USER_NAME_COLUMN.' = ?', $credential->getUsername())
                 ->where($this->ACTIVE_COLUMN.   ' = ?', true)
-                ->where($this->PASSWORD_COLUMN. ' = ?',hash_hmac('sha256',
+                ->where(
+                    $this->PASSWORD_COLUMN. ' = ?', hash_hmac('sha256',
                     $this->getUserSalt($credential->getUsername()),
                     $credential->getPassword())
                 )
@@ -201,6 +204,7 @@ class DbUserBackend implements UserBackend {
      * Create a new instance of User from a query result
      *
      * @param array $result The query result-array containing the column
+     *
      * @return User The created instance of User.
      */
     private function createUserFromResult(Array $result)
@@ -209,7 +213,8 @@ class DbUserBackend implements UserBackend {
             $result[$this->USER_NAME_COLUMN],
             $result[$this->FIRST_NAME_COLUMN],
             $result[$this->LAST_NAME_COLUMN],
-            $result[$this->EMAIL_COLUMN]);
+            $result[$this->EMAIL_COLUMN]
+        );
         $usr->setDomain($result[$this->DOMAIN_COLUMN]);
         return $usr;
     }

library/Icinga/Authentication/Manager.php

@@ -28,11 +28,11 @@
 
 namespace Icinga\Authentication;
 
-use Icinga\Application\Logger;
+use \Icinga\Application\Logger;
 use \Icinga\Application\Config as IcingaConfig;
-use Icinga\Application\DbAdapterFactory;
-use Icinga\Exception\ConfigurationError as ConfigError;
-use Icinga\User;
+use \Icinga\Application\DbAdapterFactory;
+use \Icinga\Exception\ConfigurationError as ConfigError;
+use \Icinga\User;
 
 /**
  *   The authentication manager allows to identify users and

library/Icinga/User/Preferences/StoreFactory.php

@@ -30,6 +30,7 @@ namespace Icinga\User\Preferences;
 
 use Icinga\User;
 use Icinga\Exception\ProgrammingError;
+use \Icinga\Application\DbAdapterFactory;
 use \Zend_Config;
 use \Zend_Db;
 
@@ -53,6 +54,7 @@ final class StoreFactory
      *
      * @param  Zend_Config $config
      * @param  User $user
+     *
      * @return FlushObserverInterface
      * @throws ProgrammingError
      */
@@ -68,33 +70,12 @@ final class StoreFactory
             }
 
             $items = $config->toArray();
+
+            if ($items['type'] == 'db') {
+                $items['dbAdapter'] = DbAdapterFactory::getDbAdapter($items['resource']);
+            }
             unset($items['type']);
 
-            // TODO(mh): Encapsulate into a db adapter factory (#4503)
-            if (isset($items['dbname'])
-                && isset($items['dbuser'])
-                && isset($items['dbpassword'])
-                && isset($items['dbhost'])
-                && isset($items['dbtype'])
-            ) {
-                $zendDbType = 'PDO_'. strtoupper($items['dbtype']);
-
-                $zendDbOptions = array(
-                    'host'     => $items['dbhost'],
-                    'username' => $items['dbuser'],
-                    'password' => $items['dbpassword'],
-                    'dbname'   => $items['dbname']
-                );
-
-                if (isset($items['port'])) {
-                    $zendDbOptions['port'] = $items['port'];
-                }
-
-                $dbAdapter = Zend_Db::factory($zendDbType, $zendDbOptions);
-
-                $items['dbAdapter'] = $dbAdapter;
-            }
-
             foreach ($items as $key => $value) {
                 $setter = 'set'. ucfirst($key);
                 if (is_callable(array($store, $setter))) {

library/Icinga/Util/ConfigAwareFactory.php

@@ -1,5 +1,29 @@
 <?php
 // {{{ICINGA_LICENSE_HEADER}}}
+/**
+ * This file is part of Icinga 2 Web.
+ *
+ * Icinga 2 Web - Head for multiple monitoring backends.
+ * Copyright (C) 2013 Icinga Development Team
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+ *
+ * @copyright 2013 Icinga Development Team <info@icinga.org>
+ * @license   http://www.gnu.org/licenses/gpl-2.0.txt GPL, version 2
+ * @author    Icinga Development Team <info@icinga.org>
+ */
 // {{{ICINGA_LICENSE_HEADER}}}
 
 namespace Icinga\Util;
@@ -17,3 +41,4 @@ interface ConfigAwareFactory
      */
     public static function setConfig($config);
 }
+

test/php/library/Icinga/Application/DbAdapterFactoryTest.php

@@ -37,12 +37,11 @@ require_once('../../library/Icinga/Application/Logger.php');
 require_once('library/Icinga/Application/ZendDbMock.php');
 require_once('../../library/Icinga/Exception/ConfigurationError.php');
 require_once('../../library/Icinga/Exception/ProgrammingError.php');
-require_once('../../library/Icinga/Application/ConfigAwareFactory.php');
+require_once('../../library/Icinga/Util/ConfigAwareFactory.php');
 require_once('../../library/Icinga/Application/DbAdapterFactory.php');
 
-use Tests\Icinga\Application\ZendDbMock;
-use Icinga\Application\DbAdapterFactory;
-use Icinga\Exception\ConfigurationError;
+use \Tests\Icinga\Application\ZendDbMock;
+use \Icinga\Application\DbAdapterFactory;
 
 /*
  * Unit test for the class DbAdapterFactory

test/php/library/Icinga/Application/ZendDbMock.php

@@ -31,7 +31,8 @@ namespace Tests\Icinga\Application;
 /**
  * Partially emulate the functionality of Zend_Db
  */
-class ZendDbMock {
+class ZendDbMock
+{
 
     /**
      * The config that was used in the last call of the factory function