added draft of an exception class for eGW, plus a global exception handler and replaced the fatal errors in the db-class plus the application rights check in the egw object with exceptions, modified the exceptions in admin_cmd* to use egw_excpetion*, instead just Exception

phpgwapi/inc/class.egw_exception.inc.php

@@ -0,0 +1,153 @@
+<?php
+/**
+ * eGroupWare API - Exceptions
+ * 
+ * This file defines as set of Exceptions used in eGroupWare.
+ * 
+ * Applications having the need for further exceptions should extends the from one defined in this file.
+ * 
+ * @link http://www.egroupware.org
+ * @author Ralf Becker <RalfBecker-AT-outdoor-training.de>
+ * @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
+ * @package api
+ * @subpackage accounts
+ * @access public
+ * @version $Id$
+ */
+
+/**
+ * eGroupWare API - Exceptions
+ * 
+ * All eGroupWare exceptions should extended this class, so we are able to eg. add some logging later.
+ */
+class egw_exception extends Exception
+{
+	// nothing yet
+}
+
+/**
+ * Base class for all exceptions about missing permissions 
+ *
+ */
+class egw_exception_no_permission extends egw_exception 
+{
+	/**
+	 * Constructor
+	 *
+	 * @param string $msg=null message, default "Permission denied!"
+	 * @param int $code=99 numerical code, default 100
+	 */
+	function __construct($msg=null,$code=100)
+	{
+		if (is_null($msg)) $msg = lang('Permisson denied!');
+		
+		parent::__construct($msg,$code);
+	}
+}
+
+/**
+ * User lacks the right to run an application
+ *
+ */
+class egw_exception_no_permission_app extends egw_exception_no_permission 
+{
+	function __construct($msg=null,$code=101)
+	{
+		if (isset($GLOBALS['egw_info']['apps'][$msg]))
+		{
+			if ($msg == 'admin')
+			{
+				$msg = lang('You need to be an eGroupWare administrator to access this functionality!');
+			}
+			else
+			{
+				$app = isset($GLOBALS['egw_info']['apps'][$currentapp]['title']) ? 
+					$GLOBALS['egw_info']['apps'][$currentapp]['title'] : $msg;
+
+				$msg = lang('You\'ve tried to open the eGroupWare application: %1, but you have no permission to access this application.', 
+						'<i>'.$app.'</i>');
+			}
+		}
+		parent::__construct($msg,$code);
+	}
+}
+
+/**
+ * User is no eGroupWare admin (no right to run the admin application)
+ *
+ */
+class egw_exception_no_permission_admin extends egw_exception_no_permission_app 
+{
+	function __construct($msg=null,$code=102)
+	{
+		if (is_null($msg)) $msg = 'admin';
+		
+		parent::__construct($msg,$code);
+	}
+}
+
+/**
+ * User lacks a record level permission, eg. he's not the owner and has no grant from the owner
+ *
+ */
+class egw_exception_no_permission_record extends egw_exception_no_permission { }
+
+/**
+ * A record or application entry was not found for the given id
+ *
+ */
+class egw_exception_not_found extends egw_exception
+{
+	/**
+	 * Constructor
+	 *
+	 * @param string $msg=null message, default "Entry not found!"
+	 * @param int $code=99 numerical code, default 2
+	 */
+	function __construct($msg=null,$code=2)
+	{
+		if (is_null($msg)) $msg = lang('Entry not found!');
+		
+		parent::__construct($msg,$code);
+	}
+}
+
+/**
+ * An necessary assumption the developer made failed, regular execution can not continue
+ *
+ */
+class egw_exception_assertion_failed extends egw_exception { }
+
+/**
+ * A method or function was called with a wrong or missing parameter
+ *
+ */
+class egw_exception_wrong_parameter extends egw_exception_assertion_failed { }
+
+/**
+ * Wrong or missing required user input
+ *
+ */
+class egw_exception_wrong_userinput extends egw_exception_assertion_failed { }
+
+/**
+ * Exceptions thrown by the egw_db class
+ *
+ */
+class egw_exception_db extends egw_exception 
+{ 
+	/**
+	 * Constructor
+	 *
+	 * @param string $msg=null message, default "Database error!"
+	 * @param unknown_type $code=100
+	 */
+	function __construct($msg=null,$code=100)
+	{
+		$this->query = $query;
+		
+		if (is_null($msg)) $msg = lang('Database error!');
+		
+		parent::__construct($msg,$code);
+	}
+}