X-Git-Url: https://git.mxchange.org/?p=shipsimu.git;a=blobdiff_plain;f=inc%2Fclasses%2Fmain%2Fclass_BaseFrameworkSystem.php;h=c1f216eee8f143fe14afa661d16bac5f7944b40d;hp=3721f6399b07bfb27dfcae42b3f7842298c1d73f;hb=7625f0ed496dbf1bb3efbb3bd327dbd0fd747af4;hpb=ff66822b5fb6a92f5dc8af55290ecb89ec7f1aaf

diff --git a/inc/classes/main/class_BaseFrameworkSystem.php b/inc/classes/main/class_BaseFrameworkSystem.php
index 3721f63..c1f216e 100644
--- a/inc/classes/main/class_BaseFrameworkSystem.php
+++ b/inc/classes/main/class_BaseFrameworkSystem.php
@@ -4,9 +4,10 @@
  * class handles saving of games etc.
  *
  * @author		Roland Haeder <webmaster@ship-simu.org>
- * @version		0.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.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
@@ -19,7 +20,7 @@
  * 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, see <http://www.gnu.org/licenses/>.
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	/**
@@ -52,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
 	 */
@@ -60,7 +66,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	/**
 	 * A human-readable description for this simulator part
 	 */
-	private $partDescr      = "Namenlose Framework-Einheit";
+	private $objectDescription      = "Namenlose Framework-Einheit";
 
 	/**
 	 * The unique ID string for identifying all type of classes
@@ -77,6 +83,16 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	private $decimals  = ","; // German
 
+	/**
+	 * The language instance for the template loader
+	 */
+	private $langInstance = null;
+
+	/**
+	 * The file I/O instance for the template loader
+	 */
+	private $fileIOInstance = null;
+
 	/***********************
 	 * Exception codes.... *
 	 ***********************/
@@ -125,6 +141,15 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	const EXCEPTION_VARIABLE_NOT_SET             = 0x02a;
 	const EXCEPTION_ATTRIBUTES_ARE_MISSING       = 0x02b;
 	const EXCEPTION_ARRAY_ELEMENTS_MISSING       = 0x02c;
+	const EXCEPTION_TEMPLATE_ENGINE_UNSUPPORTED  = 0x02d;
+	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;
 
 	/**
 	 * In the super constructor these system classes shall be ignored or else
@@ -135,16 +160,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
 	);
 
 	/**
@@ -152,9 +177,12 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 *
 	 * @return	void
 	 */
-	private function __construct ($class) {
+	protected function __construct ($class) {
 		// Set real class
 		$this->setRealClass($class);
+
+		// Init this instance
+		$this->initInstance($class);
 	}
 
 	/**
@@ -173,7 +201,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 			}
 
 			// Destroy all informations about this class but keep some text about it alive
-			$this->setPartDescr(sprintf("Entferntes Objekt <em>%s</em>", $this->__toString()));
+			$this->setObjectDescription(sprintf("Entferntes Objekt <em>%s</em>", $this->__toString()));
 			$this->setRealClass("DestructedObject");
 			$this->resetUniqueID();
 		} elseif ((defined('DEBUG_DESTRUCTOR')) && (is_object($this->getDebugInstance()))) {
@@ -191,8 +219,50 @@ 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 BaseFramework) {
+					// 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)";
+				} 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(),
@@ -205,14 +275,11 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	}
 
 	/**
-	 * Public constructor (for initializing things, etc.)
+	 * Initializes the instance
 	 *
 	 * @return	void
 	 */
-	public function constructor ($class) {
-		// Call constructor
-		$this->__construct($class);
-
+	public function initInstance ($class) {
 		// Get the current (singleton) configuration instance
 		$this->setConfigInstance(FrameworkConfiguration::createFrameworkConfiguration());
 
@@ -234,7 +301,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 				);
 
 				// 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)
 				));
@@ -261,27 +328,18 @@ 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()
-			));
 		}
 	}
 
 	/**
 	 * Setter for language instance
 	 *
-	 * @param		$configInstance	The configuration instance which shall
+	 * @param	$configInstance	The configuration instance which shall
 	 *							be FrameworkConfiguration
 	 * @return	void
 	 */
 	public final function setConfigInstance (FrameworkConfiguration $configInstance) {
-		$this->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()
-		));
+		self::$cfgInstance = $configInstance;
 	}
 
 	/**
@@ -289,12 +347,8 @@ 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(),
-			$this->cfgInstance->__toString()
-		));
-		return $this->cfgInstance;
+	protected final function getConfigInstance () {
+		return self::$cfgInstance;
 	}
 
 	/**
@@ -305,10 +359,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()
-		));
 	}
 
 	/**
@@ -328,10 +378,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()
-		));
 	}
 
 	/**
@@ -351,9 +397,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;
 	}
 
@@ -363,9 +406,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;
 	}
 
@@ -389,15 +429,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;
@@ -440,13 +473,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);
@@ -475,7 +502,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 			$this->__toString(),
 			md5(sprintf("%s:%s:%s:%s:%s:%s",
 				$this->__toString(),
-				$this->getPartDescr(),
+				$this->getObjectDescription(),
 				time(),
 				getenv('REMOTE_ADDR'),
 				getenv('SERVER_ADDR'),
@@ -494,12 +521,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;
 	}
@@ -510,9 +531,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;
 	}
 
@@ -524,24 +542,17 @@ 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);
 	}
 
 	/**
 	 * Getter for simulator description
 	 *
-	 * @return	$partDescr	The description of this simulation part
+	 * @return	$objectDescription	The description of this simulation part
 	 */
-	public final function getPartDescr () {
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] getPartDescr erreicht.<br />\n",
-			$this->__toString()
-		));
-		if (isset($this->partDescr)) {
-			return $this->partDescr;
+	public final function getObjectDescription () {
+		if (isset($this->objectDescription)) {
+			return $this->objectDescription;
 		} else {
 			return null;
 		}
@@ -550,15 +561,11 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	/**
 	 * Setter for simulation part description
 	 *
-	 * @param		$partDescr 	The description as string for this simulation part
+	 * @param		$objectDescription 	The description as string for this simulation part
 	 * @return	void
 	 */
-	public final function setPartDescr ($partDescr) {
-		$this->partDescr = (String) $partDescr;
-		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->partDescr
-		));
+	public final function setObjectDescription ($objectDescription) {
+		$this->objectDescription = (String) $objectDescription;
 	}
 
 	/**
@@ -568,11 +575,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	boolean	The result of comparing both's unique ID
 	 */
 	public final function equals ($object) {
-		if ((defined('DEBUG_SYSTEM')) && (is_object($this->getDebugInstance()))) $this->getDebugInstance()->output(sprintf("[%s:] Ist <strong>%s</strong>=<strong>%s</strong>?<br />\n",
-			$this->__toString(),
-			$this->__toString(),
-			$object->__toString()
-		));
 		return ($this->getUniqueID() == $object->getUniqueID());
 	}
 
@@ -585,8 +587,11 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	public function itemMatches ($itemInstance) {
 		return (
-			   ($this->__toString()   == $itemInstance->__toString())
-			&& ($this->getPartDescr() == $itemInstance->getPartDescr())
+			(
+				$this->__toString()   == $itemInstance->__toString()
+			) && (
+				$this->getObjectDescription() == $itemInstance->getObjectDescription()
+			)
 		);
 	}
 
@@ -597,11 +602,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);
 	}
 
@@ -645,10 +645,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",
@@ -666,9 +662,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);
 	}
@@ -679,10 +672,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;
 	}
 
@@ -724,7 +713,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @throws	InvalidArrayCountException	If the array contains less or
 	 *									more than two elements
 	 */
-	public function getPathFileNameFromObject () {
+	public final function getPathFileNameFromObject () {
 		// Get the main object's unique ID. We use this as a path/filename combination
 		$pathFile = $this->getUniqueID();
 
@@ -751,7 +740,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	/**
 	 * Appends a trailing slash to a string
 	 *
-	 * @param		$str		A string (maybe) without trailing slash
+	 * @param	$str		A string (maybe) without trailing slash
 	 * @return	$str		A string with an auto-appended trailing slash
 	 */
 	public final function addMissingTrailingSlash ($str) {
@@ -759,6 +748,159 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		if (substr($str, -1, 1) != "/") $str .= "/";
 		return $str;
 	}
+
+	/**
+	 * Private getter for language instance
+	 *
+	 * @return	$langInstance	An instance to the language sub-system
+	 */
+	protected final function getLanguageInstance () {
+		return $this->langInstance;
+	}
+
+	/**
+	 * Setter for language instance
+	 *
+	 * @param	$langInstance	An instance to the language sub-system
+	 * @return	void
+	 * @see		LanguageSystem
+	 */
+	public final function setLanguageInstance (ManageableLanguage $langInstance) {
+		$this->langInstance = $langInstance;
+	}
+
+	/**
+	 * Private getter for file IO instance
+	 *
+	 * @return	$fileIOInstance	An instance to the file I/O sub-system
+	 */
+	protected final function getFileIoInstance () {
+		return $this->fileIOInstance;
+	}
+
+	/**
+	 * Setter for file I/O instance
+	 *
+	 * @param	$fileIOInstance	An instance to the file I/O sub-system
+	 * @return	void
+	 */
+	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 or
+	 *										null if we shall use the default
+	 * @return		$tplEngine				The template engine instance
+	 * @throws		NullPointerException	If the template engine could not
+	 *										be initialized
+	 * @throws		UnsupportedTemplateEngineException	If $tplEngine is an
+	 * 										unsupported template engine
+	 * @throws		MissingLanguageHandlerException	If the language sub-system
+	 * 										is not yet initialized
+	 * @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"),
+			strtolower($appInstance->getAppShortName()),
+			$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) {
+			// Invalid language instance
+			throw new MissingFileIoHandlerException($appInstance, self::EXCEPTION_MISSING_FILE_IO_HANDLER);
+		}
+
+		// Initialize the template engine
+		$tplEngine = null;
+		$eval = sprintf("\$tplEngine = %s::create%s(
+	\"%s\",
+	\$appInstance->getLanguageInstance(),
+	\$appInstance->getFileIoInstance()
+);",
+			$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:] Constructed PHP command: <pre><em>%s</em></pre><br />\n",
+				$this->__toString(),
+				htmlentities($eval)
+			));
+		}
+
+		// Run the command
+		eval($eval);
+
+		// Is it a valid instance?
+		if (is_null($tplEngine)) {
+			// No class returned
+			throw new NullPointerException($this, self::EXCEPTION_IS_NULL_POINTER);
+		} elseif (!$tplEngine instanceof CompileableTemplate) {
+			// Not an object! ;-(
+			throw new UnsupportedTemplateEngineException($tplEngine, self::EXCEPTION_TEMPLATE_ENGINE_UNSUPPORTED);
+		}
+
+		// 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 = "<pre>".trim(print_r($this, true))."</pre>";
+
+		// Output it
+		ApplicationEntryPoint::app_die("<strong>Debug output:</strong>".$content);
+	}
 }
 
 // [EOF]