KjwObject.php

<?php // vim:ts=4:sw=4:noet
/*====================================================================== 
Copyright (C) 2006-2009, Walter Doekes
This file is part of KjwLib-php45.
 
KjwLib-php45 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 3 of the License, or 
(at your option) any later version. 

KjwLib-php45 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 KjwLib-php45.  If not, see <http://www.gnu.org/licenses/>. 
======================================================================*/

require_once(dirname(__FILE__) . '/KjwLib.php');

static $kjw_object_count = 0;

class KjwObject {
        var $_kjwobject_id = -1;                        
        var $_kjwobject_last_error;                     
        function KjwObject() {
                global $kjw_object_count;
                ++$kjw_object_count;
                static $kjwobject_id = 0;
                $this->_kjwobject_id = ++$kjwobject_id;
                $this->_kjwobject_last_error = null;

                if (KJW_DEBUG)
                        $this->trace("Creating " . $this->id() . ", total objects now = $kjw_object_count.", 'MEMORY');
        }

        function destroy() {
                global $kjw_object_count;
                --$kjw_object_count;
                if (KJW_DEBUG)
                        $this->trace("Destroying " . $this->id() . ", total objects left = $kjw_object_count.", 'MEMORY');
        }
        
        function id() {
                return 'KjwObject(#' . $this->_kjwobject_id . ')::' . get_class($this);
        }

        function setError($errorMessage) {
                assert('is_string($errorMessage)');
                $this->trace("(transient) $errorMessage", 'ERROR');
                if ($this->_kjwobject_last_error === null)
                        $this->_kjwobject_last_error = $errorMessage;
        }

        function getError() {
                return $this->_kjwobject_last_error;
        }

        function notImplemented() {
                $this->croak('Library Component Error', 'Abstract method not implemented!');
        }

        function trace($msg, $level = 'DEBUG') {
                kjw_trace($msg, $level, $this->id());
        }

        function croak($shortMsg, $detailedMsg, $backtraceShift = 1) {
                kjw_croak($this->id(), $shortMsg, $detailedMsg, $backtraceShift);
        }
}

?>

---