X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;ds=sidebyside;f=inc%2Fclasses%2Fmain%2Fclass_BaseFrameworkSystem.php;fp=inc%2Fclasses%2Fmain%2Fclass_BaseFrameworkSystem.php;h=4abdf2995886afc834c0f3ffefa31412df5de770;hb=3f7247b52f1b837bb70e6d8584e3f762ba17cb05;hp=dbf69b14f3a7f50d3657fee3f306596409f8db5a;hpb=bde5ba03c1ba1277cfba56f0d6892a3b9246d3b3;p=mailer.git

diff --git a/inc/classes/main/class_BaseFrameworkSystem.php b/inc/classes/main/class_BaseFrameworkSystem.php
index dbf69b14f3..4abdf29958 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
@@ -20,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 {
 	/**
@@ -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,10 @@ 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;
 
 	/**
 	 * In the super constructor these system classes shall be ignored or else
@@ -150,16 +159,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
 	);
 
 	/**
@@ -167,9 +176,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);
 	}
 
 	/**
@@ -220,14 +232,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());
 
@@ -249,7 +258,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)
 				));
@@ -276,27 +285,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;
 	}
 
 	/**
@@ -305,11 +305,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(),
-			$this->cfgInstance->__toString()
-		));
-		return $this->cfgInstance;
+		return self::$cfgInstance;
 	}
 
 	/**
@@ -320,10 +316,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 +335,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 +354,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 +363,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 +386,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 +430,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 +478,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 +488,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 +499,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 +508,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 +523,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 +559,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);
 	}
 
@@ -658,10 +602,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 +619,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 +629,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;
 	}
 
@@ -812,11 +745,31 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		$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,8 +777,22 @@ 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,
@@ -857,7 +824,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 
 		// 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 +845,19 @@ 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 = "<pre>".trim(print_r($this, true))."</pre>";
+
+		// Output it
+		ApplicationEntryPoint::app_die("<strong>Debug output:</strong>".$content);
+	}
 }
 
 // [EOF]