3 * An abstract database access class for handling database I/O requests
5 * @see DatabaseFrontendInterface - An interface for database frontends (front-end to the application)
6 * @author Roland Haeder <webmaster@mxchange.org>
8 * @copyright Copyright(c) 2007, 2008 Roland Haeder, this is free software
9 * @license GNU GPL 3.0 or any newer version
10 * @link http://www.mxchange.org
12 * This program is free software: you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation, either version 3 of the License, or
15 * (at your option) any later version.
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with this program. If not, see <http://www.gnu.org/licenses/>.
25 abstract class BaseDatabaseFrontend extends BaseFrameworkSystem implements DatabaseFrontendInterface, LimitableObject {
27 * The limiter instance
29 private $limitInstance = null;
32 * Protected constructor
36 protected function __construct($class) {
37 // Call parent constructor
38 parent::__construct($class);
41 if (((defined('DEBUG_DATABASE')) || (defined('DEBUG_ALL'))) && (defined('DEBUG_CONSTRUCT'))) $this->getDebugInstance()->output(sprintf("[%s:] Konstruktor erreicht.<br />\n",
46 $this->removeNumberFormaters();
50 * Getter for limitation instance
52 * @return $limitInstance The instance to the object ObjectLimits
54 public final function getLimitInstance () {
55 if ((defined('DEBUG_DATABASE')) || (defined('DEBUG_ALL'))) $this->getDebugInstance()->output(sprintf("[%s:] Limitierungsinstanz <strong>%s</strong> angefordert.<br />\n",
57 $this->limitInstance->__toString()
59 return $this->limitInstance;
63 * Setup limitation for the saving process
65 * @param $limitInstance An instance of ObjectLimits which contains
66 * elements we shall exclusivly include in
70 public final function limitObject (ObjectLimits $limitInstance) {
72 if ((defined('DEBUG_DATABASE')) || (defined('DEBUG_ALL'))) $this->getDebugInstance()->output(sprintf("[%s:] Limitierungsinstanz <strong>%s</strong> soll verwendet werden.<br />\n",
74 $limitInstance->__toString()
77 // Get limitArray for validation
78 $array = $limitInstance->getLimitArray();
80 // Sanity-check if some limitations are in the object
81 if ($array->count() > 0) {
82 // Okay, there is enougth
83 $this->limitInstance = $limitInstance;
86 if ((defined('DEBUG_DATABASE')) || (defined('DEBUG_ALL'))) $this->getDebugInstance()->output(sprintf("[%s:] Limitierungsinstanz <strong>%s</strong> wird verwendet und beinhaltet <strong>%s</strong> Einträge.<br />\n",
88 $limitInstance->__toString(),