X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=inc%2Fclasses%2Fmain%2Fclass_BaseFrameworkSystem.php;h=0d8213210adf2000e0592850a8902b8258cf1755;hb=dc97c9dc65dcbd007a4c5118674a03ff326a6dca;hp=796860a240861b315167783a24ceb3f395d7653f;hpb=1d128d8532290e84885d09d2d3f0060abd08e49e;p=shipsimu.git

diff --git a/inc/classes/main/class_BaseFrameworkSystem.php b/inc/classes/main/class_BaseFrameworkSystem.php
index 796860a..0d82132 100644
--- a/inc/classes/main/class_BaseFrameworkSystem.php
+++ b/inc/classes/main/class_BaseFrameworkSystem.php
@@ -4,10 +4,10 @@
  * class handles saving of games etc.
  *
  * @author		Roland Haeder <webmaster@ship-simu.org>
- * @version		0.3.0
+ * @version		0.0.0
  * @copyright	Copyright(c) 2007, 2008 Roland Haeder, this is free software
  * @license		GNU GPL 3.0 or any newer version
- * @link		http://www.mxchange.org
+ * @link		http://www.ship-simu.org
  *
  * 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
@@ -53,6 +53,11 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	private $dbInstance  = null;
 
+	/**
+	 * Instance to an application helper class
+	 */
+	private $applicationInstance = null;
+
 	/**
 	 * The real class name
 	 */
@@ -140,6 +145,12 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	const EXCEPTION_MISSING_LANGUAGE_HANDLER     = 0x02e;
 	const EXCEPTION_MISSING_FILE_IO_HANDLER      = 0x02f;
 	const EXCEPTION_MISSING_ELEMENT              = 0x030;
+	const EXCEPTION_INVALID_COMMAND              = 0x031;
+	const EXCEPTION_INVALID_CONTROLLER           = 0x032;
+	const EXCEPTION_HEADERS_ALREADY_SENT         = 0x033;
+	const EXCEPTION_DEFAUL_CONTROLLER_GONE       = 0x034;
+	const EXCEPTION_CLASS_NOT_FOUND              = 0x035;
+	const EXCEPTION_REQUIRED_INTERFACE_MISSING   = 0x036;
 
 	/**
 	 * In the super constructor these system classes shall be ignored or else
@@ -150,16 +161,16 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 *--------------------------------------------------------------------*
 	 */
 	private $systemClasses = array(
-		"DebugMiddleware",			// Debug middleware output sub-system
-		"DebugWebOutput",			// Debug web output sub-system
-		"DebugConsoleOutput",		// Debug console output sub-system
-		"DebugErrorLogOutput",		// Debug error_log() output sub-system
-		"CompressorChannel",		// Compressor sub-system
+		"DebugMiddleware",				// Debug middleware output sub-system
+		"DebugWebOutput",				// Debug web output sub-system
+		"DebugConsoleOutput",			// Debug console output sub-system
+		"DebugErrorLogOutput",			// Debug error_log() output sub-system
+		"CompressorChannel",			// Compressor sub-system
 		"FrameworkDirectoryPointer",	// Directory handler sub-system
-		"NullCompressor",			// Null compressor
-		"Bzip2Compressor",			// BZIP2 compressor
-		"GzipCompressor",			// GZIP compressor
-		"WebOutput",				// Web output sub-system
+		"NullCompressor",				// Null compressor
+		"Bzip2Compressor",				// BZIP2 compressor
+		"GzipCompressor",				// GZIP compressor
+		"WebOutput",					// Web output sub-system
 	);
 
 	/**
@@ -209,8 +220,53 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	public final function __call ($methodName, $args) {
 		// Implode all given arguments
-		$argsString = implode("|", $args);
-		if (empty($argsString)) $argsString = "NULL";
+		$argsString = "";
+		if (empty($args)) {
+			// No arguments
+			$argsString = "NULL";
+		} elseif (is_array($args)) {
+			// Some arguments are there
+			foreach ($args as $arg) {
+				// Check the type
+				if (is_bool($arg)) {
+					// Boolean!
+					if ($arg) $argsString .= "true(bool)"; else $argsString .= "false(bool)";
+				} elseif (is_int($arg)) {
+					// Integer
+					$argsString .= $arg."(int)";
+				} elseif (is_float($arg)) {
+					// Floating point
+					$argsString .= $arg."(float)";
+				} elseif ($arg instanceof BaseFrameworkSystem) {
+					// Own object instance
+					$argsString .= $arg->__toString()."(Object)";
+				} elseif (is_object($arg)) {
+					// External object
+					$argsString .= "unknown object(!)";
+				} elseif (is_array($arg)) {
+					// Array
+					$argsString .= "Array(array)";
+				} elseif (is_string($arg)) {
+					// String
+					$argsString .= "\"".$arg."\"(string)";
+				} elseif (is_null($arg)) {
+					// Null
+					$argsString .= "(null)";
+				} else {
+					// Unknown type (please report!)
+					$argsString .= $arg."(unknown!)";
+				}
+
+				// Add comma
+				$argsString .= ", ";
+			}
+
+			// Remove last comma
+			if (substr($argsString, -2, 1) === ",") $argsString = substr($argsString, 0, -2);
+		} else {
+			// Invalid arguments!
+			$argsString = sprintf("!INVALID:%s!", $args);
+		}
 
 		$this->getDebugInstance()->output(sprintf("[%s::%s] Stub! Args: %s",
 			$this->__toString(),
@@ -236,20 +292,20 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 			// Initialize debug instance
 			if (is_null($this->getDebugInstance())) {
 				// Set the debug output system if it is not debug class ;)
-				$this->setDebugInstance(DebugMiddleware::createDebugMiddleware($this->getConfigInstance()->readConfig("debug_engine")));
+				$this->setDebugInstance(DebugMiddleware::createDebugMiddleware($this->getConfigInstance()->readConfig('debug_engine')));
 			}
 
 			// Initialize web instance
 			if (is_null($this->getWebOutputInstance())) {
 				// Generate the eval() command
 				$eval = sprintf("\$this->setWebOutputInstance(%s::create%s(\"%s\"));",
-					$this->getConfigInstance()->readConfig("web_engine"),
-					$this->getConfigInstance()->readConfig("web_engine"),
-					$this->getConfigInstance()->readConfig("web_content_type")
+					$this->getConfigInstance()->readConfig('web_engine'),
+					$this->getConfigInstance()->readConfig('web_engine'),
+					$this->getConfigInstance()->readConfig('web_content_type')
 				);
 
 				// Debug message
-				if ((defined('DEBUG_EVAL')) || (defined('DEBUG_ALL'))) $this->getDebugInstance()->output(sprintf("[%s:] Konstruierte PHP-Anweisung: <pre><em>%s</em></pre><br />\n",
+				if (defined('DEBUG_EVAL')) $this->getDebugInstance()->output(sprintf("[%s:] Constructed PHP command: <pre><em>%s</em></pre><br />\n",
 					$this->__toString(),
 					htmlentities($eval)
 				));
@@ -263,7 +319,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 				// Set the compressor channel
 				$this->setCompressorChannel(CompressorChannel::createCompressorChannel(sprintf("%s%s",
 					PATH,
-					$this->getConfigInstance()->readConfig("compressor_base_path")
+					$this->getConfigInstance()->readConfig('compressor_base_path')
 				)));
 			}
 
@@ -276,11 +332,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 					$this->setDatabaseInstance($db);
 				}
 			}
-
-			// Debug output
-			if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] Alle Sub-Systeme sind initialisiert.<br />\n",
-				$this->__toString()
-			));
 		}
 	}
 
@@ -293,10 +344,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	public final function setConfigInstance (FrameworkConfiguration $configInstance) {
 		self::$cfgInstance = $configInstance;
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] Konfigurations-Handler auf <strong>%s</strong> gesetzt.<br />\n",
-			$this->__toString(),
-			$configInstance->__toString()
-		));
 	}
 
 	/**
@@ -304,11 +351,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 *
 	 * @return	$cfhInstance - Configuration instance
 	 */
-	public final function getConfigInstance () {
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] Konfigurations-Handler <strong>%s</strong> angefordert.<br />\n",
-			$this->__toString(),
-			self::$cfgInstance->__toString()
-		));
+	protected final function getConfigInstance () {
 		return self::$cfgInstance;
 	}
 
@@ -320,10 +363,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	public final function setDebugInstance (DebugMiddleware $debugInstance) {
 		self::$debug = $debugInstance;
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] Debug-Handler auf <strong>%s</strong> gesetzt.<br />\n",
-			$this->__toString(),
-			$this->getDebugInstance()->__toString()
-		));
 	}
 
 	/**
@@ -343,10 +382,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	public final function setWebOutputInstance (OutputStreamer $webInstance) {
 		self::$webOutput = $webInstance;
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] Web-Handler auf <strong>%s</strong> gesetzt.<br />\n",
-			$this->__toString(),
-			$this->getWebOutputInstance()->__toString()
-		));
 	}
 
 	/**
@@ -366,9 +401,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	void
 	 */
 	public final function setDatabaseInstance (DatabaseConnection $dbInstance) {
-		if ((defined('DEBUG_SYSTEM')) && (is_object($dbInstance->getDebugInstance()))) $dbInstance->getDebugInstance()->output(sprintf("[%s:] Datenbankschicht gesetzt.<br />\n",
-			$dbInstance->__toString()
-		));
 		$this->dbInstance = $dbInstance;
 	}
 
@@ -378,9 +410,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	$realClass The name of the real class (not BaseFrameworkSystem)
 	 */
 	public final function __toString () {
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] __toString() erreicht.<br />\n",
-			$this->realClass
-		));
 		return $this->realClass;
 	}
 
@@ -404,15 +433,8 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	void
 	 */
 	public final function createUniqueID () {
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] createUniqueID aufgerufen.<br />\n",
-			$this->__toString()
-		));
-
 		// Existiert noch keine?
 		if (empty($this->uniqueID)) {
-			if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] createUniqueID erzeugt neue Unique-ID.<br />\n",
-				$this->__toString()
-			));
 
 			// Correct missing class name
 			$corrected = false;
@@ -455,13 +477,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 					// Abort the loop
 					break;
 				}
-			}
-
-			// Debug message
-			if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] uniqueID ist auf <strong>%s</strong> gesetzt.<br />\n",
-				$this->__toString(),
-				$tempID
-			));
+			} // END - while
 
 			// Apply the new ID
 			$this->setUniqueID($tempID);
@@ -509,12 +525,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		// Cast to string
 		$uniqueID = (string) $uniqueID;
 
-		// Debug message
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] Unique-ID gesetzt auf <u>%s</u>.<br />\n",
-			$this->__toString(),
-			$uniqueID
-		));
-
 		// Set the ID number
 		$this->uniqueID = $uniqueID;
 	}
@@ -525,9 +535,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return 	$uniqueID		The unique ID of this class
 	 */
 	public final function getUniqueID () {
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] Unique-ID angefordert.<br />\n",
-			$this->__toString()
-		));
 		return $this->uniqueID;
 	}
 
@@ -539,10 +546,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	public final function resetUniqueID() {
 		// Sweet and simple... ;-)
 		$newUniqueID = $this->generateIdNumber();
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] Unique-ID zur&uuml;ckgesetzt auf <u>%s</u>.<br />\n",
-			$this->__toString(),
-			$newUniqueID
-		));
 		$this->setUniqueID($newUniqueID);
 	}
 
@@ -552,9 +555,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	$objectDescription	The description of this simulation part
 	 */
 	public final function getObjectDescription () {
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] getObjectDescription erreicht.<br />\n",
-			$this->__toString()
-		));
 		if (isset($this->objectDescription)) {
 			return $this->objectDescription;
 		} else {
@@ -570,10 +570,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	public final function setObjectDescription ($objectDescription) {
 		$this->objectDescription = (String) $objectDescription;
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] Teilbeschreibung wird auf <strong>%s</strong> gesetzt.<br />\n",
-			$this->__toString(),
-			$this->objectDescription
-		));
 	}
 
 	/**
@@ -610,11 +606,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	boolean	The result of comparing both class names
 	 */
 	public final function isClass ($class) {
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] <strong>%s</strong>=<strong>%s</strong>?<br />\n",
-			$this->__toString(),
-			$this->__toString(),
-			$class
-		));
 		return ($this->__toString() == $class);
 	}
 
@@ -641,10 +632,10 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * Formats computer generated price values into human-understandable formats
 	 * with thousand and decimal seperators.
 	 *
-	 * @param		$value	The in computer format value for a price
-	 * @param		$currency	The currency symbol (use HTML-valid characters!)
-	 * @param		$decNum	Number of decimals after commata
-	 * @return	$price	The for the current language formated price string
+	 * @param	$value		The in computer format value for a price
+	 * @param	$currency	The currency symbol (use HTML-valid characters!)
+	 * @param	$decNum		Number of decimals after commata
+	 * @return	$price		The for the current language formated price string
 	 * @throws	MissingDecimalsThousandsSeperatorException	If decimals or
 	 *												thousands seperator
 	 *												is missing
@@ -658,10 +649,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 
 		// Cast the number
 		$value = (float) $value;
-		if (defined('DEBUG_CORE') && is_object($this->getDebugInstance())) $this->getDebugInstance()->output(sprintf("[%s:] <strong>%d</strong> wird umformatiert.<br />\n",
-			$this->__toString(),
-			$value
-		));
 
 		// Reformat the US number
 		$price = sprintf("%s %s",
@@ -679,9 +666,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	void
 	 */
 	public final function removeNumberFormaters () {
-		if (defined('DEBUG_CORE') && is_object($this->getDebugInstance())) $this->getDebugInstance()->output(sprintf("[%s:] Zahlenumformatierungszeichen werden entfernt.<br />\n",
-			$this->__toString()
-		));
 		unset($this->thousands);
 		unset($this->decimals);
 	}
@@ -692,10 +676,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	$dbInstance	The database layer instance
 	 */
 	public final function getDatabaseInstance () {
-		if (defined('DEBUG_CORE') && is_object($this->getDebugInstance())) $this->getDebugInstance()->output(sprintf("[%s:] Datenbank-Instanz <u>%s</u> angefordert.<br />\n",
-			$this->__toString(),
-			$this->dbInstance
-		));
 		return $this->dbInstance;
 	}
 
@@ -798,7 +778,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 *
 	 * @return	$fileIOInstance	An instance to the file I/O sub-system
 	 */
-	protected final function getFileIOInstance () {
+	protected final function getFileIoInstance () {
 		return $this->fileIOInstance;
 	}
 
@@ -808,15 +788,35 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @param	$fileIOInstance	An instance to the file I/O sub-system
 	 * @return	void
 	 */
-	public final function setFileIOInstance (FileIOHandler $fileIOInstance) {
+	public final function setFileIoInstance (FileIoHandler $fileIOInstance) {
 		$this->fileIOInstance = $fileIOInstance;
 	}
 
+	/**
+	 * Protected getter for a manageable application helper class
+	 *
+	 * @return	$applicationInstance	An instance of a manageable application helper class
+	 */
+	protected final function getApplicationInstance () {
+		return $this->applicationInstance;
+	}
+
+	/**
+	 * Setter for a manageable application helper class
+	 *
+	 * @param	$applicationInstance	An instance of a manageable application helper class
+	 * @return	void
+	 */
+	public final function setApplicationInstance (ManageableApplication $applicationInstance) {
+		$this->applicationInstance = $applicationInstance;
+	}
+
 	/**
 	 * Prepare the template engine (TemplateEngine by default) for a given
 	 * application helper instance (ApplicationHelper by default).
 	 *
-	 * @param		$appInstance			An application helper instance
+	 * @param		$appInstance			An application helper instance or
+	 *										null if we shall use the default
 	 * @return		$tplEngine				The template engine instance
 	 * @throws		NullPointerException	If the template engine could not
 	 *										be initialized
@@ -824,21 +824,35 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * 										unsupported template engine
 	 * @throws		MissingLanguageHandlerException	If the language sub-system
 	 * 										is not yet initialized
-	 */
-	protected function prepareTemplateEngine (BaseFrameworkSystem $appInstance) {
+	 * @throws		NullPointerException	If the discovered application
+	 *										instance is still null
+	 */
+	protected function prepareTemplateEngine (BaseFrameworkSystem $appInstance=null) {
+		// Is the application instance set?
+		if (is_null($appInstance)) {
+			// Get the current instance
+			$appInstance = $this->getApplicationInstance();
+
+			// Still null?
+			if (is_null($appInstance)) {
+				// Thrown an exception
+				throw new NullPointerException($this, self::EXCEPTION_IS_NULL_POINTER);
+			}
+		}
+
 		// Generate FQFN for all application templates
 		$fqfn = sprintf("%s%s/%s/%s",
 			PATH,
-			$this->getConfigInstance()->readConfig("application_path"),
+			$this->getConfigInstance()->readConfig('application_path'),
 			strtolower($appInstance->getAppShortName()),
-			$this->getConfigInstance()->readConfig("tpl_base_path")
+			$this->getConfigInstance()->readConfig('tpl_base_path')
 		);
 
 		// Are both instances set?
 		if ($appInstance->getLanguageInstance() === null) {
 			// Invalid language instance
 			throw new MissingLanguageHandlerException($appInstance, self::EXCEPTION_MISSING_LANGUAGE_HANDLER);
-		} elseif ($appInstance->getFileIOInstance() === null) {
+		} elseif ($appInstance->getFileIoInstance() === null) {
 			// Invalid language instance
 			throw new MissingFileIoHandlerException($appInstance, self::EXCEPTION_MISSING_FILE_IO_HANDLER);
 		}
@@ -848,16 +862,16 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		$eval = sprintf("\$tplEngine = %s::create%s(
 	\"%s\",
 	\$appInstance->getLanguageInstance(),
-	\$appInstance->getFileIOInstance()
+	\$appInstance->getFileIoInstance()
 );",
-			$this->getConfigInstance()->readConfig("tpl_engine"),
-			$this->getConfigInstance()->readConfig("tpl_engine"),
+			$this->getConfigInstance()->readConfig('tpl_engine'),
+			$this->getConfigInstance()->readConfig('tpl_engine'),
 			$fqfn
 		);
 
 		// Debug message
 		if ((!is_null($this->getDebugInstance())) && (defined('DEBUG_EVAL'))) {
-			$this->getDebugInstance()->output(sprintf("[%s:] Konstruierte PHP-Anweisung: <pre><em>%s</em></pre><br />\n",
+			$this->getDebugInstance()->output(sprintf("[%s:] Constructed PHP command: <pre><em>%s</em></pre><br />\n",
 				$this->__toString(),
 				htmlentities($eval)
 			));
@@ -878,6 +892,85 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		// Return the prepared instance
 		return $tplEngine;
 	}
+
+	/**
+	 * Debugs this instance by putting out it's full content
+	 *
+	 * @return	void
+	 */
+	public final function debugInstance () {
+		// Generate the output
+		$content = sprintf("<pre>%s</pre>",
+			trim(print_r($this, true))
+		);
+
+		// Output it
+		ApplicationEntryPoint::app_die(sprintf("<strong>%s debug output:</strong>%s", $this->__toString(), $content));
+	}
+
+	/**
+	 * Output a partial stub message for the caller method
+	 *
+	 * @param	$message	An optional message to display
+	 * @return	void
+	 */
+	protected function partialStub ($message = "") {
+		// Get the backtrace
+		$backtrace = debug_backtrace();
+
+		// Generate the class::method string
+		$methodName = "UnknownClass::unknownMethod";
+		if ((isset($backtrace[1]['class'])) && (isset($backtrace[1]['function']))) {
+			$methodName = $backtrace[1]['class']."::".$backtrace[1]['function'];
+		}
+
+		// Construct the full message
+		$stubMessage = sprintf("[%s:] Partial stub!",
+			$methodName
+		);
+
+		// Is the extra message given?
+		if (!empty($message)) {
+			// Then add it as well
+			$stubMessage .= sprintf(" Message: <u>%s</u>", $message);
+		}
+
+		// Debug instance is there?
+		if (!is_null($this->getDebugInstance())) {
+			// Output stub message
+			$this->getDebugInstance()->output($stubMessage);
+		} else {
+			// Trigger an error
+			trigger_error($stubMessage."<br />\n");
+		}
+	}
+
+	/**
+	 * Converts e.g. a command from URL to a valid class by keeping out bad characters
+	 *
+	 * @param	$str		The string, what ever it is needs to be converted
+	 * @return	$className	Generated class name
+	 */
+	public function convertToClassName ($str) {
+		$className = "";
+		foreach (explode("_", $str) as $strPart) {
+			$className .= ucfirst(strtolower($strPart));
+		}
+		return $className;
+	}
+
+	/**
+	 * Outputs a debug backtrace and stops further script execution
+	 *
+	 * @return	void
+	 */
+	public function debugBacktrace () {
+		// Sorry, there is no other way getting this nice backtrace
+		print "<pre>\n";
+		debug_print_backtrace();
+		print "</pre>";
+		exit;
+	}
 }
 
 // [EOF]