X-Git-Url: https://git.mxchange.org/?p=core.git;a=blobdiff_plain;f=inc%2Fclasses%2Fmain%2Fclass_BaseFrameworkSystem.php;h=d66487ae9498c5799f263892637fc73ebc88ccc7;hp=da54f83abacc82a7339912022a82e635adaaf7d9;hb=904af48e1bdec1bea7a5ffecfe4795bea7e25eb5;hpb=0088a32f8609875b6151dfa516f7c2d92fa3a5a8

diff --git a/inc/classes/main/class_BaseFrameworkSystem.php b/inc/classes/main/class_BaseFrameworkSystem.php
index da54f83a..d66487ae 100644
--- a/inc/classes/main/class_BaseFrameworkSystem.php
+++ b/inc/classes/main/class_BaseFrameworkSystem.php
@@ -3,11 +3,11 @@
  * The simulator system class is the super class of all other classes. This
  * class handles saving of games etc.
  *
- * @author		Roland Haeder <webmaster@ship-simu.org>
+ * @author		Roland Haeder <webmaster@shipsimu.org>
  * @version		0.0.0
- * @copyright	Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2012 Core Developer Team
+ * @copyright	Copyright (c) 2007, 2008 Roland Haeder, 2009 - 2013 Core Developer Team
  * @license		GNU GPL 3.0 or any newer version
- * @link		http://www.ship-simu.org
+ * @link		http://www.shipsimu.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
@@ -23,6 +23,16 @@
  * along with this program. If not, see <http://www.gnu.org/licenses/>.
  */
 class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
+	/**
+	 * Length of count
+	 */
+	const LENGTH_COUNT = 20;
+
+	/**
+	 * Length of position
+	 */
+	const LENGTH_POSITION = 20;
+
 	/**
 	 * The real class name
 	 */
@@ -144,12 +154,12 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	private $sourceInstance = NULL;
 
 	/**
-	 * An instance of a InputStreamable class
+	 * An instance of a InputStream class
 	 */
 	private $inputStreamInstance = NULL;
 
 	/**
-	 * An instance of a OutputStreamable class
+	 * An instance of a OutputStream class
 	 */
 	private $outputStreamInstance = NULL;
 
@@ -163,11 +173,26 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	private $visitorInstance = NULL;
 
+	/**
+	 * DHT instance
+	 */
+	private $dhtInstance = NULL;
+
 	/**
 	 * An instance of a database wrapper class
 	 */
 	private $wrapperInstance = NULL;
 
+	/**
+	 * An instance of a file I/O pointer class (not handler)
+	 */
+	private $pointerInstance = NULL;
+
+	/**
+	 * An instance of an index
+	 */
+	private $indexInstance = NULL;
+
 	/**
 	 * Thousands separator
 	 */
@@ -181,13 +206,53 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	/**
 	 * Socket resource
 	 */
-	private $socketResource = false;
+	private $socketResource = FALSE;
 
 	/**
 	 * Package data
 	 */
 	private $packageData = array();
 
+	/**
+	 * Generic array
+	 */
+	private $genericArray = array();
+
+	/**
+	 * Length of output from hash()
+	 */
+	private static $hashLength = NULL;
+
+	/**
+	 * Counter for total entries
+	 */
+	private $totalEntries = 0;
+
+	/**
+	 * Current seek position
+	 */
+	private $seekPosition = 0;
+
+	/**
+	 * Size of header
+	 */
+	private $headerSize = 0;
+
+	/**
+	 * File header
+	 */
+	private $header = array();
+
+	/**
+	 * Seek positions for gaps ("fragmentation")
+	 */
+	private $gaps = array();
+
+	/**
+	 * Seek positions for damaged entries (e.g. mismatching hash sum, ...)
+	 */
+	private $damagedEntries = array();
+
 	/***********************
 	 * Exception codes.... *
 	 ***********************/
@@ -239,6 +304,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	const EXCEPTION_ARRAY_ELEMENTS_MISSING       = 0x02c;
 	const EXCEPTION_TEMPLATE_ENGINE_UNSUPPORTED  = 0x02d;
 	const EXCEPTION_UNSPPORTED_OPERATION         = 0x02e;
+	const EXCEPTION_FACTORY_REQUIRE_PARAMETER    = 0x02f;
 	const EXCEPTION_MISSING_ELEMENT              = 0x030;
 	const EXCEPTION_HEADERS_ALREADY_SENT         = 0x031;
 	const EXCEPTION_DEFAULT_CONTROLLER_GONE      = 0x032;
@@ -249,7 +315,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	const EXCEPTION_ASSERTION_FAILED             = 0x037;
 	const EXCEPTION_FILE_CANNOT_BE_READ          = 0x038;
 	const EXCEPTION_DATABASE_UPDATED_NOT_ALLOWED = 0x039;
-	const EXCEPTION_FILTER_CHAIN_INTERCEPTED     = 0x040;
+	const EXCEPTION_FILTER_CHAIN_INTERCEPTED     = 0x03a;
 
 	/**
 	 * Hexadecimal->Decimal translation array
@@ -316,10 +382,10 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 			$this->setConfigInstance(FrameworkConfiguration::getSelfInstance());
 		} // END - if
 
-		// Is the startup time set? (0 cannot be true anymore)
+		// Is the startup time set? (0 cannot be TRUE anymore)
 		if (self::$startupTime == 0) {
 			// Then set it
-			self::$startupTime = microtime(true);
+			self::$startupTime = microtime(TRUE);
 		} // END - if
 	}
 
@@ -338,10 +404,14 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 			$this->setRealClass('DestructedObject');
 		} elseif ((defined('DEBUG_DESTRUCTOR')) && (is_object($this->getDebugInstance()))) {
 			// Already destructed object
-			self::createDebugInstance(__CLASS__)->debugOutput(sprintf("[%s:] The object <span class=\"object_name\">%s</span> is already destroyed.",
+			self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:] The object <span class="object_name">%s</span> is already destroyed.',
 				__CLASS__,
 				$this->__toString()
 			));
+		} else {
+			// Do not call this twice
+			trigger_error(__METHOD__ . ': Called twice.');
+			exit;
 		}
 	}
 
@@ -364,8 +434,10 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	void
 	 */
 	public static final function __callStatic ($methodName, $args) {
-		// Implode all given arguments
+		// Init argument string
 		$argsString = '';
+
+		// Is it empty or an array?
 		if (empty($args)) {
 			// No arguments
 			$argsString = 'NULL';
@@ -388,12 +460,12 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 				} elseif (is_array($arg)) {
 					// .. or size if array
 					$argsString .= ', ' . count($arg);
-				} elseif ($arg === true) {
-					// ... is boolean 'true'
-					$argsString .= ', true';
-				} elseif ($arg === false) {
-					// ... is boolean 'true'
-					$argsString .= ', false';
+				} elseif ($arg === TRUE) {
+					// ... is boolean 'TRUE'
+					$argsString .= ', TRUE';
+				} elseif ($arg === FALSE) {
+					// ... is boolean 'FALSE'
+					$argsString .= ', FALSE';
 				}
 
 				// Closing bracket
@@ -411,7 +483,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 
 		// Output stub message
 		// @TODO __CLASS__ does always return BaseFrameworkSystem but not the extending (=child) class
-		self::createDebugInstance(__CLASS__)->debugOutput(sprintf("[unknown::%s:] Stub! Args: %s",
+		self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[unknown::%s:] Stub! Args: %s',
 			$methodName,
 			$argsString
 		));
@@ -437,7 +509,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	void
 	 */
 	public final function __set ($name, $value) {
-		$this->debugBackTrace(sprintf("Tried to set a missing field. name=%s, value[%s]=%s",
+		$this->debugBackTrace(sprintf('Tried to set a missing field. name=%s, value[%s]=%s',
 			$name,
 			gettype($value),
 			$value
@@ -451,7 +523,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	void
 	 */
 	public final function __get ($name) {
-		$this->debugBackTrace(sprintf("Tried to get a missing field. name=%s",
+		$this->debugBackTrace(sprintf('Tried to get a missing field. name=%s',
 			$name
 		));
 	}
@@ -463,7 +535,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	void
 	 */
 	public final function __unset ($name) {
-		$this->debugBackTrace(sprintf("Tried to unset a missing field. name=%s",
+		$this->debugBackTrace(sprintf('Tried to unset a missing field. name=%s',
 			$name
 		));
 	}
@@ -776,7 +848,7 @@ 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 (IoHandler $fileIoInstance) {
 		$this->fileIoInstance = $fileIoInstance;
 	}
 
@@ -990,19 +1062,19 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	}
 
 	/**
-	 * Setter for BaseDatabaseWrapper instance
+	 * Setter for DatabaseWrapper instance
 	 *
-	 * @param	$wrapperInstance	An instance of an BaseDatabaseWrapper
+	 * @param	$wrapperInstance	An instance of an DatabaseWrapper
 	 * @return	void
 	 */
-	public final function setWrapperInstance (BaseDatabaseWrapper $wrapperInstance) {
+	public final function setWrapperInstance (DatabaseWrapper $wrapperInstance) {
 		$this->wrapperInstance = $wrapperInstance;
 	}
 
 	/**
-	 * Getter for BaseDatabaseWrapper instance
+	 * Getter for DatabaseWrapper instance
 	 *
-	 * @return	$wrapperInstance	An instance of an BaseDatabaseWrapper
+	 * @return	$wrapperInstance	An instance of an DatabaseWrapper
 	 */
 	public final function getWrapperInstance () {
 		return $this->wrapperInstance;
@@ -1068,40 +1140,40 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	}
 
 	/**
-	 * Getter for a InputStreamable instance
+	 * Getter for a InputStream instance
 	 *
-	 * @param	$inputStreamInstance	The InputStreamable instance
+	 * @param	$inputStreamInstance	The InputStream instance
 	 */
 	protected final function getInputStreamInstance () {
 		return $this->inputStreamInstance;
 	}
 
 	/**
-	 * Setter for a InputStreamable instance
+	 * Setter for a InputStream instance
 	 *
-	 * @param	$inputStreamInstance	The InputStreamable instance
+	 * @param	$inputStreamInstance	The InputStream instance
 	 * @return	void
 	 */
-	protected final function setInputStreamInstance (InputStreamable $inputStreamInstance) {
+	protected final function setInputStreamInstance (InputStream $inputStreamInstance) {
 		$this->inputStreamInstance = $inputStreamInstance;
 	}
 
 	/**
-	 * Getter for a OutputStreamable instance
+	 * Getter for a OutputStream instance
 	 *
-	 * @param	$outputStreamInstance	The OutputStreamable instance
+	 * @param	$outputStreamInstance	The OutputStream instance
 	 */
 	protected final function getOutputStreamInstance () {
 		return $this->outputStreamInstance;
 	}
 
 	/**
-	 * Setter for a OutputStreamable instance
+	 * Setter for a OutputStream instance
 	 *
-	 * @param	$outputStreamInstance	The OutputStreamable instance
+	 * @param	$outputStreamInstance	The OutputStream instance
 	 * @return	void
 	 */
-	protected final function setOutputStreamInstance (OutputStreamable $outputStreamInstance) {
+	protected final function setOutputStreamInstance (OutputStream $outputStreamInstance) {
 		$this->outputStreamInstance = $outputStreamInstance;
 	}
 
@@ -1143,6 +1215,25 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		return $this->visitorInstance;
 	}
 
+	/**
+	 * Setter for DHT instance
+	 *
+	 * @param	$dhtInstance	A Distributable instance
+	 * @return	void
+	 */
+	protected final function setDhtInstance (Distributable $dhtInstance) {
+		$this->dhtInstance = $dhtInstance;
+	}
+
+	/**
+	 * Getter for DHT instance
+	 *
+	 * @return	$dhtInstance	A Distributable instance
+	 */
+	protected final function getDhtInstance () {
+		return $this->dhtInstance;
+	}
+
 	/**
 	 * Setter for raw package Data
 	 *
@@ -1182,6 +1273,44 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		return $this->iteratorInstance;
 	}
 
+	/**
+	 * Setter for InputOutputPointer instance
+	 *
+	 * @param	$pointerInstance	An instance of an InputOutputPointer class
+	 * @return	void
+	 */
+	protected final function setPointerInstance (InputOutputPointer $pointerInstance) {
+		$this->pointerInstance = $pointerInstance;
+	}
+
+	/**
+	 * Getter for InputOutputPointer instance
+	 *
+	 * @return	$pointerInstance	An instance of an InputOutputPointer class
+	 */
+	public final function getPointerInstance () {
+		return $this->pointerInstance;
+	}
+
+	/**
+	 * Setter for Indexable instance
+	 *
+	 * @param	$indexInstance	An instance of an Indexable class
+	 * @return	void
+	 */
+	protected final function setIndexInstance (Indexable $indexInstance) {
+		$this->indexInstance = $indexInstance;
+	}
+
+	/**
+	 * Getter for Indexable instance
+	 *
+	 * @return	$indexInstance	An instance of an Indexable class
+	 */
+	public final function getIndexInstance () {
+		return $this->indexInstance;
+	}
+
 	/**
 	 * Checks whether an object equals this object. You should overwrite this
 	 * method to implement own equality checks
@@ -1303,20 +1432,20 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		// Is a message set?
 		if (!empty($message)) {
 			// Construct message
-			$content = sprintf("<div class=\"debug_message\">Message: %s</div>\n", $message);
+			$content = sprintf('<div class="debug_message">Message: %s</div>' . PHP_EOL, $message);
 		} // END - if
 
 		// Generate the output
-		$content .= sprintf("<pre>%s</pre>",
+		$content .= sprintf('<pre>%s</pre>',
 			trim(
 				htmlentities(
-					print_r($this, true)
+					print_r($this, TRUE)
 				)
 			)
 		);
 
 		// Output it
-		ApplicationEntryPoint::app_exit(sprintf("<div class=\"debug_header\">%s debug output:</div><div class=\"debug_content\">%s</div>\nLoaded includes: <div class=\"debug_include_list\">%s</div>",
+		ApplicationEntryPoint::app_exit(sprintf('<div class="debug_header">%s debug output:</div><div class="debug_content">%s</div>Loaded includes: <div class="debug_include_list">%s</div>',
 			$this->__toString(),
 			$content,
 			ClassLoader::getSelfInstance()->getPrintableIncludeList()
@@ -1376,6 +1505,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		} else {
 			// Trigger an error
 			trigger_error($stubMessage);
+			exit;
 		}
 	}
 
@@ -1383,10 +1513,10 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * Outputs a debug backtrace and stops further script execution
 	 *
 	 * @param	$message	An optional message to output
-	 * @param	$doExit		Whether exit the program (true is default)
+	 * @param	$doExit		Whether exit the program (TRUE is default)
 	 * @return	void
 	 */
-	public function debugBackTrace ($message = '', $doExit = true) {
+	public function debugBackTrace ($message = '', $doExit = TRUE) {
 		// Sorry, there is no other way getting this nice backtrace
 		if (!empty($message)) {
 			// Output message
@@ -1398,7 +1528,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		print('</pre>');
 
 		// Exit program?
-		if ($doExit === true) {
+		if ($doExit === TRUE) {
 			exit();
 		} // END - if
 	}
@@ -1410,25 +1540,45 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @return	$debugInstance	An instance of a debugger class
 	 */
 	public final static function createDebugInstance ($className) {
-		// Init debug instance
-		$debugInstance = NULL;
+		// Is the instance set?
+		if (!Registry::getRegistry()->instanceExists('debug')) {
+			// Init debug instance
+			$debugInstance = NULL;
+
+			// Try it
+			try {
+				// Get a debugger instance
+				$debugInstance = DebugMiddleware::createDebugMiddleware(FrameworkConfiguration::getSelfInstance()->getConfigEntry('debug_class'));
+			} catch (NullPointerException $e) {
+				// Didn't work, no instance there
+				exit('Cannot create debugInstance! Exception=' . $e->__toString() . ', message=' . $e->getMessage());
+			}
 
-		// Try it
-		try {
-			// Get a debugger instance
-			$debugInstance = DebugMiddleware::createDebugMiddleware(FrameworkConfiguration::getSelfInstance()->getConfigEntry('debug_class'));
-		} catch (NullPointerException $e) {
-			// Didn't work, no instance there
-			exit('Cannot create debugInstance! Exception=' . $e->__toString() . ', message=' . $e->getMessage());
-		}
+			// Empty string should be ignored and used for testing the middleware
+			DebugMiddleware::getSelfInstance()->output('');
 
-		// Empty string should be ignored and used for testing the middleware
-		DebugMiddleware::getSelfInstance()->output('');
+			// Set it in its own class. This will set it in the registry
+			$debugInstance->setDebugInstance($debugInstance);
+		} else {
+			// Get instance from registry
+			$debugInstance = Registry::getRegistry()->getDebugInstance();
+		}
 
 		// Return it
 		return $debugInstance;
 	}
 
+	/**
+	 * Simple output of a message with line-break
+	 *
+	 * @param	$message	Message to output
+	 * @return	void
+	 */
+	public function outputLine ($message) {
+		// Simply output it
+		print($message . PHP_EOL);
+	}
+
 	/**
 	 * Outputs a debug message whether to debug instance (should be set!) or
 	 * dies with or ptints the message. Do NEVER EVER rewrite the exit() call to
@@ -1436,10 +1586,10 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 *
 	 * @param	$message	Message we shall send out...
 	 * @param	$doPrint	Whether print or die here (default: print)
-	 * @paran	$stripTags	Whether to strip tags (default: false)
+	 * @paran	$stripTags	Whether to strip tags (default: FALSE)
 	 * @return	void
 	 */
-	public function debugOutput ($message, $doPrint = true, $stripTags = false) {
+	public function debugOutput ($message, $doPrint = TRUE, $stripTags = FALSE) {
 		// Set debug instance to NULL
 		$debugInstance = NULL;
 
@@ -1456,7 +1606,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 			// Use debug output handler
 			$debugInstance->output($message, $stripTags);
 
-			if ($doPrint === false) {
+			if ($doPrint === FALSE) {
 				// Die here if not printed
 				exit();
 			} // END - if
@@ -1468,9 +1618,9 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 			} // END - if
 
 			// Put directly out
-			if ($doPrint === true) {
+			if ($doPrint === TRUE) {
 				// Print message
-				print($message . chr(10));
+				$this->outputLine($message);
 			} else {
 				// Die here
 				exit($message);
@@ -1637,7 +1787,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		$this->getResultInstance()->rewind();
 
 		// Do we have an entry?
-		if ($this->getResultInstance()->valid() === false) {
+		if ($this->getResultInstance()->valid() === FALSE) {
 			throw new InvalidDatabaseResultException(array($this, $this->getResultInstance()), DatabaseResult::EXCEPTION_INVALID_DATABASE_RESULT);
 		} // END - if
 
@@ -1673,7 +1823,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 
 		// Get current array
 		$fieldArray = $resultInstance->current();
-		//* DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput($fieldName.':<pre>'.print_r($fieldArray, true).'</pre>');
+		//* DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput($fieldName.':<pre>'.print_r($fieldArray, TRUE).'</pre>');
 
 		// Convert dashes to underscore
 		$fieldName = $this->convertDashesToUnderscores($fieldName);
@@ -1730,6 +1880,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 			} else {
 				// Trigger an error
 				trigger_error($message . "<br />\n");
+				exit;
 			}
 		} else {
 			// @TODO Finish this part!
@@ -1759,7 +1910,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	public function getMilliTime () {
 		// Get the time of day as float
-		$milliTime = gettimeofday(true);
+		$milliTime = gettimeofday(TRUE);
 
 		// Return it
 		return $milliTime;
@@ -1772,7 +1923,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	public function idle ($milliSeconds) {
 		// Sleep is fine by default
-		$hasSlept = true;
+		$hasSlept = TRUE;
 
 		// Idle so long with found function
 		if (function_exists('time_sleep_until')) {
@@ -1825,8 +1976,8 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	}
 
 	/**
-	 * Converts even very large decimal numbers, also with negative sign, to a
-	 * hexadecimal string.
+	 * Converts even very large decimal numbers, also signed, to a hexadecimal
+	 * string.
 	 *
 	 * This work is based on comment #97756 on php.net documentation page at:
 	 * <http://de.php.net/manual/en/function.hexdec.php#97756>
@@ -1849,18 +2000,20 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		// Encode the decimal number into a hexadecimal string
 		$hex = '';
 		do {
-			$hex = self::$dechex[($dec % 16)] . $hex;
-			$dec /= 16;
+			$hex = self::$dechex[($dec % (2 ^ 4))] . $hex;
+			$dec /= (2 ^ 4);
 		} while ($dec >= 1);
 
 		/*
-		 * We need hexadecimal strings with leading zeros if the length cannot
-		 * be divided by 2
+		 * Leading zeros are required for hex-decimal "numbers". In some
+		 * situations more leading zeros are wanted, so check for both
+		 * conditions.
 		 */
 		if ($maxLength > 0) {
 			// Prepend more zeros
-			$hex = $this->prependStringToString($hex, '0', $maxLength);
+			$hex = str_pad($hex, $maxLength, '0', STR_PAD_LEFT);
 		} elseif ((strlen($hex) % 2) != 0) {
+			// Only make string's length dividable by 2
 			$hex = '0' . $hex;
 		}
 
@@ -1928,41 +2081,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		return $asc;
 	}
 
-	/**
-	 * Prepends a given string $prepend to $str with a given total length
-	 *
-	 * @param	$str		Given original string which should be prepended
-	 * @param	$prepend	The string to prepend
-	 * @param	$length		Total length of the final string
-	 * @return	$strFinal	Final prepended string
-	 */
-	protected function prependStringToString ($str, $prepend, $length) {
-		// Set final string to original string by default
-		$strFinal = $str;
-
-		// Can it devided
-		if (strlen($str) < $length) {
-			// Difference between total length and length of original string
-			$diff = $length - strlen($str);
-
-			// Prepend the string
-			$prepend = str_repeat($prepend, ($diff / strlen($prepend) + 1));
-
-			// Make sure it will definedly fit
-			assert(strlen($prepend) >= $diff);
-
-			// Cut it a little down
-			$prepend = substr($prepend, 0, $diff);
-			//* DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('prepend('.strlen($prepend).')='.$prepend.',diff='.$diff.',length='.$length);
-
-			// Construct the final prepended string
-			$strFinal = $prepend . $str;
-		} // END - if
-
-		// Return it
-		return $strFinal;
-	}
-
 	/**
 	 * Checks whether the given encoded data was encoded with Base64
 	 *
@@ -1971,7 +2089,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	protected function isBase64Encoded ($encodedData) {
 		// Determine it
-		$isBase64 = (@base64_decode($encodedData, true) !== false);
+		$isBase64 = (@base64_decode($encodedData, TRUE) !== FALSE);
 
 		// Return it
 		return $isBase64;
@@ -2005,7 +2123,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	protected function getCacheKeyByCriteria (Criteria $criteriaInstance, array $onlyKeys = array()) {
 		// Generate it
-		$cacheKey = sprintf("%s@%s",
+		$cacheKey = sprintf('%s@%s',
 			$this->__toString(),
 			$criteriaInstance->getCacheKey($onlyKeys)
 		);
@@ -2031,7 +2149,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	protected function getPrintableExecutionTime () {
 		// Caculate the execution time
-		$executionTime = microtime(true) - $this->getStartupTime();
+		$executionTime = microtime(TRUE) - $this->getStartupTime();
 
 		// Pack it in nice braces
 		$executionTime = sprintf('[ %01.5f ] ', $executionTime);
@@ -2041,19 +2159,37 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	}
 
 	/**
-	 * Hashes a given string with a simple but stronger hash function (no salts)
+	 * Hashes a given string with a simple but stronger hash function (no salt)
+	 * and hex-encode it.
 	 *
 	 * @param	$str	The string to be hashed
 	 * @return	$hash	The hash from string $str
 	 */
-	public function hashString ($str) {
+	public static final function hash ($str) {
 		// Hash given string with (better secure) hasher
-		$hash = mhash(MHASH_SHA256, $str);
+		$hash = bin2hex(mhash(MHASH_SHA256, $str));
 
 		// Return it
 		return $hash;
 	}
 
+	/**
+	 * "Getter" for length of hash() output. This will be "cached" to speed up
+	 * things.
+	 *
+	 * @return	$length		Length of hash() output
+	 */
+	public static final function getHashLength () {
+		// Is it cashed?
+		if (is_null(self::$hashLength)) {
+			// No, then hash a string and save its length.
+			self::$hashLength = strlen(self::hash('abc123'));
+		} // END - if
+
+		// Return it
+		return self::$hashLength;
+	}
+
 	/**
 	 * Checks whether the given number is really a number (only chars 0-9).
 	 *
@@ -2062,18 +2198,18 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @param	$assertMismatch		Whether to assert mismatches
 	 * @return	$ret		The (hopefully) secured numbered value
 	 */
-	public function bigintval ($num, $castValue = true, $assertMismatch = false) {
+	public function bigintval ($num, $castValue = TRUE, $assertMismatch = FALSE) {
 		// Filter all numbers out
 		$ret = preg_replace('/[^0123456789]/', '', $num);
 
 		// Shall we cast?
-		if ($castValue === true) {
+		if ($castValue === TRUE) {
 			// Cast to biggest numeric type
 			$ret = (double) $ret;
 		} // END - if
 
 		// Assert only if requested
-		if ($assertMismatch === true) {
+		if ($assertMismatch === TRUE) {
 			// Has the whole value changed?
 			assert(('' . $ret . '' != '' . $num . '') && (!is_null($num)));
 		} // END - if
@@ -2089,12 +2225,12 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 * @param	$assertMismatch		Whether to assert mismatches
 	 * @return	$ret	The (hopefully) secured hext-numbered value
 	 */
-	public function hexval ($num, $assertMismatch = false) {
+	public function hexval ($num, $assertMismatch = FALSE) {
 		// Filter all numbers out
 		$ret = preg_replace('/[^0123456789abcdefABCDEF]/', '', $num);
 
 		// Assert only if requested
-		if ($assertMismatch === true) {
+		if ($assertMismatch === TRUE) {
 			// Has the whole value changed?
 			assert(('' . $ret . '' != '' . $num . '') && (!is_null($num)));
 		} // END - if
@@ -2102,6 +2238,892 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		// Return result
 		return $ret;
 	}
+
+	/**
+	 * Checks whether start/end marker are set
+	 *
+	 * @param	$data	Data to be checked
+	 * @return	$isset	Whether start/end marker are set
+	 */
+	public final function ifStartEndMarkersSet ($data) {
+		// Determine it
+		$isset = ((substr($data, 0, strlen(BaseRawDataHandler::STREAM_START_MARKER)) == BaseRawDataHandler::STREAM_START_MARKER) && (substr($data, -1 * strlen(BaseRawDataHandler::STREAM_END_MARKER), strlen(BaseRawDataHandler::STREAM_END_MARKER)) == BaseRawDataHandler::STREAM_END_MARKER));
+
+		// ... and return it
+		return $isset;
+	}
+
+	/**
+	 * Determines if an element is set in the generic array
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to check
+	 * @param	$element	Element to check
+	 * @return	$isset		Whether the given key is set
+	 */
+	protected final function isGenericArrayElementSet ($keyGroup, $subGroup, $key, $element) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',element=' . $element);
+
+		// Is it there?
+		$isset = isset($this->genericArray[$keyGroup][$subGroup][$key][$element]);
+
+		// Return it
+		return $isset;
+	}
+	/**
+	 * Determines if a key is set in the generic array
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to check
+	 * @return	$isset		Whether the given key is set
+	 */
+	protected final function isGenericArrayKeySet ($keyGroup, $subGroup, $key) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key);
+
+		// Is it there?
+		$isset = isset($this->genericArray[$keyGroup][$subGroup][$key]);
+
+		// Return it
+		return $isset;
+	}
+
+
+	/**
+	 * Determines if a group is set in the generic array
+	 *
+	 * @param	$keyGroup	Main group
+	 * @param	$subGroup	Sub group
+	 * @return	$isset		Whether the given group is set
+	 */
+	protected final function isGenericArrayGroupSet ($keyGroup, $subGroup) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup);
+
+		// Is it there?
+		$isset = isset($this->genericArray[$keyGroup][$subGroup]);
+
+		// Return it
+		return $isset;
+	}
+
+	/**
+	 * Getter for sub key group
+	 *
+	 * @param	$keyGroup	Main key group
+	 * @param	$subGroup	Sub key group
+	 * @return	$array		An array with all array elements
+	 */
+	protected final function getGenericSubArray ($keyGroup, $subGroup) {
+		// Is it there?
+		if (!$this->isGenericArrayGroupSet($keyGroup, $subGroup)) {
+			// No, then abort here
+			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ' not found.');
+			exit;
+		} // END - if
+
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',value=' . print_r($this->genericArray[$keyGroup][$subGroup], TRUE));
+
+		// Return it
+		return $this->genericArray[$keyGroup][$subGroup];
+	}
+
+	/**
+	 * Unsets a given key in generic array
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to unset
+	 * @return	void
+	 */
+	protected final function unsetGenericArrayKey ($keyGroup, $subGroup, $key) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key);
+
+		// Remove it
+		unset($this->genericArray[$keyGroup][$subGroup][$key]);
+	}
+
+	/**
+	 * Unsets a given element in generic array
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to unset
+	 * @param	$element	Element to unset
+	 * @return	void
+	 */
+	protected final function unsetGenericArrayElement ($keyGroup, $subGroup, $key, $element) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',element=' . $element);
+
+		// Remove it
+		unset($this->genericArray[$keyGroup][$subGroup][$key][$element]);
+	}
+
+	/**
+	 * Append a string to a given generic array key
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to unset
+	 * @param	$value		Value to add/append
+	 * @return	void
+	 */
+	protected final function appendStringToGenericArrayKey ($keyGroup, $subGroup, $key, $value, $appendGlue = '') {
+		// Debug message
+		//* NOISY-DEBUG: */ if (!is_object($value)) $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',value[' . gettype($value) . ']=' . print_r($value, TRUE) . ',appendGlue=' . $appendGlue);
+
+		// Is it already there?
+		if ($this->isGenericArrayKeySet($keyGroup, $subGroup, $key)) {
+			// Append it
+			$this->genericArray[$keyGroup][$subGroup][$key] .= $appendGlue . (string) $value;
+		} else {
+			// Add it
+			$this->genericArray[$keyGroup][$subGroup][$key] = (string) $value;
+		}
+	}
+
+	/**
+	 * Append a string to a given generic array element
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to unset
+	 * @param	$element	Element to check
+	 * @param	$value		Value to add/append
+	 * @return	void
+	 */
+	protected final function appendStringToGenericArrayElement ($keyGroup, $subGroup, $key, $element, $value, $appendGlue = '') {
+		// Debug message
+		//* NOISY-DEBUG: */ if (!is_object($value)) $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',element=' . $element . ',value[' . gettype($value) . ']=' . print_r($value, TRUE) . ',appendGlue=' . $appendGlue);
+
+		// Is it already there?
+		if ($this->isGenericArrayElementSet($keyGroup, $subGroup, $key, $element)) {
+			// Append it
+			$this->genericArray[$keyGroup][$subGroup][$key][$element] .= $appendGlue . (string) $value;
+		} else {
+			// Add it
+			$this->genericArray[$keyGroup][$subGroup][$key][$element] = (string) $value;
+		}
+	}
+
+	/**
+	 * Initializes given generic array group
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to use
+	 * @param	$forceInit	Optionally force initialization
+	 * @return	void
+	 */
+	protected final function initGenericArrayGroup ($keyGroup, $subGroup, $forceInit = FALSE) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',forceInit=' . intval($forceInit));
+
+		// Is it already set?
+		if (($forceInit === FALSE) && ($this->isGenericArrayGroupSet($keyGroup, $subGroup))) {
+			// Already initialized
+			trigger_error(__METHOD__ . ':keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ' already initialized.');
+			exit;
+		} // END - if
+
+		// Initialize it
+		$this->genericArray[$keyGroup][$subGroup] = array();
+	}
+
+	/**
+	 * Initializes given generic array key
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to use
+	 * @param	$forceInit	Optionally force initialization
+	 * @return	void
+	 */
+	protected final function initGenericArrayKey ($keyGroup, $subGroup, $key, $forceInit = FALSE) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',forceInit=' . intval($forceInit));
+
+		// Is it already set?
+		if (($forceInit === FALSE) && ($this->isGenericArrayKeySet($keyGroup, $subGroup, $key))) {
+			// Already initialized
+			trigger_error(__METHOD__ . ':keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ' already initialized.');
+			exit;
+		} // END - if
+
+		// Initialize it
+		$this->genericArray[$keyGroup][$subGroup][$key] = array();
+	}
+
+	/**
+	 * Initializes given generic array element
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to use
+	 * @param	$element	Element to use
+	 * @param	$forceInit	Optionally force initialization
+	 * @return	void
+	 */
+	protected final function initGenericArrayElement ($keyGroup, $subGroup, $key, $element, $forceInit = FALSE) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',element=' . $element . ',forceInit=' . intval($forceInit));
+
+		// Is it already set?
+		if (($forceInit === FALSE) && ($this->isGenericArrayElementSet($keyGroup, $subGroup, $key, $element))) {
+			// Already initialized
+			trigger_error(__METHOD__ . ':keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',element=' . $element . ' already initialized.');
+			exit;
+		} // END - if
+
+		// Initialize it
+		$this->genericArray[$keyGroup][$subGroup][$key][$element] = array();
+	}
+
+	/**
+	 * Pushes an element to a generic key
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to use
+	 * @param	$value		Value to add/append
+	 * @return	$count		Number of array elements
+	 */
+	protected final function pushValueToGenericArrayKey ($keyGroup, $subGroup, $key, $value) {
+		// Debug message
+		//* NOISY-DEBUG: */ if (!is_object($value)) $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',value[' . gettype($value) . ']=' . print_r($value, TRUE));
+
+		// Is it set?
+		if (!$this->isGenericArrayKeySet($keyGroup, $subGroup, $key)) {
+			// Initialize array
+			$this->initGenericArrayKey($keyGroup, $subGroup, $key);
+		} // END - if
+
+		// Then push it
+		$count = array_push($this->genericArray[$keyGroup][$subGroup][$key], $value);
+
+		// Return count
+		//* DEBUG: */ print(__METHOD__ . ': genericArray=' . print_r($this->genericArray[$keyGroup][$subGroup][$key], TRUE));
+		//* DEBUG: */ print(__METHOD__ . ': count=' . $count . PHP_EOL);
+		return $count;
+	}
+
+	/**
+	 * Pushes an element to a generic array element
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to use
+	 * @param	$element	Element to check
+	 * @param	$value		Value to add/append
+	 * @return	$count		Number of array elements
+	 */
+	protected final function pushValueToGenericArrayElement ($keyGroup, $subGroup, $key, $element, $value) {
+		// Debug message
+		//* NOISY-DEBUG: */ if (!is_object($value)) $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',element=' . $element . ',value[' . gettype($value) . ']=' . print_r($value, TRUE));
+
+		// Is it set?
+		if (!$this->isGenericArrayElementSet($keyGroup, $subGroup, $key, $element)) {
+			// Initialize array
+			$this->initGenericArrayElement($keyGroup, $subGroup, $key, $element);
+		} // END - if
+
+		// Then push it
+		$count = array_push($this->genericArray[$keyGroup][$subGroup][$key][$element], $value);
+
+		// Return count
+		//* DEBUG: */ print(__METHOD__ . ': genericArray=' . print_r($this->genericArray[$keyGroup][$subGroup][$key], TRUE));
+		//* DEBUG: */ print(__METHOD__ . ': count=' . $count . PHP_EOL);
+		return $count;
+	}
+
+	/**
+	 * Pops an element from  a generic group
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to unset
+	 * @return	$value		Last "popped" value
+	 */
+	protected final function popGenericArrayElement ($keyGroup, $subGroup, $key) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key);
+
+		// Is it set?
+		if (!$this->isGenericArrayKeySet($keyGroup, $subGroup, $key)) {
+			// Not found
+			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ' not found.');
+			exit;
+		} // END - if
+
+		// Then "pop" it
+		$value = array_pop($this->genericArray[$keyGroup][$subGroup][$key]);
+
+		// Return value
+		//* DEBUG: */ print(__METHOD__ . ': genericArray=' . print_r($this->genericArray[$keyGroup][$subGroup][$key], TRUE));
+		//* DEBUG: */ print(__METHOD__ . ': value[' . gettype($value) . ']=' . print_r($value, TRUE) . PHP_EOL);
+		return $value;
+	}
+
+	/**
+	 * Shifts an element from  a generic group
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to unset
+	 * @return	$value		Last "popped" value
+	 */
+	protected final function shiftGenericArrayElement ($keyGroup, $subGroup, $key) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key);
+
+		// Is it set?
+		if (!$this->isGenericArrayKeySet($keyGroup, $subGroup, $key)) {
+			// Not found
+			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ' not found.');
+			exit;
+		} // END - if
+
+		// Then "shift" it
+		$value = array_shift($this->genericArray[$keyGroup][$subGroup][$key]);
+
+		// Return value
+		//* DEBUG: */ print(__METHOD__ . ': genericArray=' . print_r($this->genericArray[$keyGroup][$subGroup][$key], TRUE));
+		//* DEBUG: */ print(__METHOD__ . ': value[' . gettype($value) . ']=' . print_r($value, TRUE) . PHP_EOL);
+		return $value;
+	}
+
+	/**
+	 * Count generic array group
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @return	$count		Count of given group
+	 */
+	protected final function countGenericArray ($keyGroup) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup);
+
+		// Is it there?
+		if (!isset($this->genericArray[$keyGroup])) {
+			// Abort here
+			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ' not found.');
+			exit;
+		} // END - if
+
+		// Then count it
+		$count = count($this->genericArray[$keyGroup]);
+
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',count=' . $count);
+
+		// Return it
+		return $count;
+	}
+
+	/**
+	 * Count generic array sub group
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @return	$count		Count of given group
+	 */
+	protected final function countGenericArrayGroup ($keyGroup, $subGroup) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup);
+
+		// Is it there?
+		if (!$this->isGenericArrayGroupSet($keyGroup, $subGroup)) {
+			// Abort here
+			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ' not found.');
+			exit;
+		} // END - if
+
+		// Then count it
+		$count = count($this->genericArray[$keyGroup][$subGroup]);
+
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',count=' . $count);
+
+		// Return it
+		return $count;
+	}
+
+	/**
+	 * Count generic array elements
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @para	$key		Key to count
+	 * @return	$count		Count of given key
+	 */
+	protected final function countGenericArrayElements ($keyGroup, $subGroup, $key) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key);
+
+		// Is it there?
+		if (!$this->isGenericArrayKeySet($keyGroup, $subGroup, $key)) {
+			// Abort here
+			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ' not found.');
+			exit;
+		} elseif (!$this->isValidGenericArrayGroup($keyGroup, $subGroup)) {
+			// Not valid
+			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ' is not an array.');
+			exit;
+		}
+
+		// Then count it
+		$count = count($this->genericArray[$keyGroup][$subGroup][$key]);
+
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',count=' . $count);
+
+		// Return it
+		return $count;
+	}
+
+	/**
+	 * Getter for whole generic group array
+	 *
+	 * @param	$keyGroup	Key group to get
+	 * @return	$array		Whole generic array group
+	 */
+	protected final function getGenericArray ($keyGroup) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup);
+
+		// Is it there?
+		if (!isset($this->genericArray[$keyGroup])) {
+			// Then abort here
+			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ' does not exist.');
+			exit;
+		} // END - if
+
+		// Return it
+		return $this->genericArray[$keyGroup];
+	}
+
+	/**
+	 * Setter for generic array key
+	 *
+	 * @param	$keyGroup	Key group to get
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to unset
+	 * @param	$value		Mixed value from generic array element
+	 * @return	void
+	 */
+	protected final function setGenericArrayKey ($keyGroup, $subGroup, $key, $value) {
+		// Debug message
+		//* NOISY-DEBUG: */ if (!is_object($value)) $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',value[' . gettype($value) . ']=' . print_r($value, TRUE));
+
+		// Set value here
+		$this->genericArray[$keyGroup][$subGroup][$key] = $value;
+	}
+
+	/**
+	 * Getter for generic array key
+	 *
+	 * @param	$keyGroup	Key group to get
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to unset
+	 * @return	$value		Mixed value from generic array element
+	 */
+	protected final function getGenericArrayKey ($keyGroup, $subGroup, $key) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key);
+
+		// Is it there?
+		if (!$this->isGenericArrayKeySet($keyGroup, $subGroup, $key)) {
+			// Then abort here
+			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ' does not exist.');
+			exit;
+		} // END - if
+
+		// Return it
+		return $this->genericArray[$keyGroup][$subGroup][$key];
+	}
+
+	/**
+	 * Sets a value in given generic array key/element
+	 *
+	 * @param	$keyGroup	Main group for the key
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to set
+	 * @param	$element	Element to set
+	 * @param	$value		Value to set
+	 * @return	void
+	 */
+	protected final function setGenericArrayElement ($keyGroup, $subGroup, $key, $element, $value) {
+		// Debug message
+		//* NOISY-DEBUG: */ if (!is_object($value)) $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',element=' . $element . ',value[' . gettype($value) . ']=' . print_r($value, TRUE));
+
+		// Then set it
+		$this->genericArray[$keyGroup][$subGroup][$key][$element] = $value;
+	}
+
+	/**
+	 * Getter for generic array element
+	 *
+	 * @param	$keyGroup	Key group to get
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to look for
+	 * @param	$element	Element to look for
+	 * @return	$value		Mixed value from generic array element
+	 */
+	protected final function getGenericArrayElement ($keyGroup, $subGroup, $key, $element) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',element=' . $element);
+
+		// Is it there?
+		if (!$this->isGenericArrayElementSet($keyGroup, $subGroup, $key, $element)) {
+			// Then abort here
+			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key . ',element=' . $element . ' does not exist.');
+			exit;
+		} // END - if
+
+		// Return it
+		return $this->genericArray[$keyGroup][$subGroup][$key][$element];
+	}
+
+	/**
+	 * Checks if a given sub group is valid (array)
+	 *
+	 * @param	$keyGroup	Key group to get
+	 * @param	$subGroup	Sub group for the key
+	 * @return	$isValid	Whether given sub group is valid
+	 */
+	protected final function isValidGenericArrayGroup ($keyGroup, $subGroup) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup);
+
+		// Determine it
+		$isValid = (($this->isGenericArrayGroupSet($keyGroup, $subGroup)) && (is_array($this->getGenericSubArray($keyGroup, $subGroup))));
+
+		// Return it
+		return $isValid;
+	}
+
+	/**
+	 * Checks if a given key is valid (array)
+	 *
+	 * @param	$keyGroup	Key group to get
+	 * @param	$subGroup	Sub group for the key
+	 * @param	$key		Key to check
+	 * @return	$isValid	Whether given sub group is valid
+	 */
+	protected final function isValidGenericArrayKey ($keyGroup, $subGroup, $key) {
+		// Debug message
+		//* NOISY-DEBUG: */ $this->outputLine('[' . __METHOD__ . ':' . __LINE__ . '] keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ',key=' . $key);
+
+		// Determine it
+		$isValid = (($this->isGenericArrayKeySet($keyGroup, $subGroup, $key)) && (is_array($this->getGenericArrayKey($keyGroup, $subGroup, $key))));
+
+		// Return it
+		return $isValid;
+	}
+
+	/**
+	 * Translates boolean TRUE to 'Y' and FALSE to 'N'
+	 *
+	 * @param	$boolean		Boolean value
+	 * @return	$translated		Translated boolean value
+	 */
+	public static final function translateBooleanToYesNo ($boolean) {
+		// Make sure it is really boolean
+		assert(is_bool($boolean));
+
+		// "Translate" it
+		$translated = ($boolean === TRUE) ? 'Y' : 'N';
+
+		// ... and return it
+		return $translated;
+	}
+
+	/**
+	 * Initializes counter for valid entries, arrays for damaged entries and
+	 * an array for gap seek positions. If you call this method on your own,
+	 * please re-analyze the file structure. So you are better to call
+	 * analyzeFile() instead of this method.
+	 *
+	 * @return	void
+	 */
+	protected function initCountersGapsArray () {
+		// Init counter and seek position
+		$this->setCounter(0);
+		$this->setSeekPosition(0);
+
+		// Init arrays
+		$this->gaps = array();
+		$this->damagedEntries = array();
+	}
+
+	/**
+	 * Getter for total entries
+	 *
+	 * @return	$totalEntries	Total entries in this file
+	 */
+	protected final function getCounter () {
+		// Get it
+		return $this->totalEntries;
+	}
+
+	/**
+	 * Setter for total entries
+	 *
+	 * @param	$totalEntries	Total entries in this file
+	 * @return	void
+	 */
+	protected final function setCounter ($counter) {
+		// Set it
+		$this->totalEntries = $counter;
+	}
+
+	/**
+	 * Increment counter
+	 *
+	 * @return	void
+	 */
+	protected final function incrementCounter () {
+		// Get it
+		$this->totalEntries++;
+	}
+
+	/**
+	 * Getter for header size
+	 *
+	 * @return	$totalEntries	Size of file header
+	 */
+	protected final function getHeaderSize () {
+		// Get it
+		return $this->headerSize;
+	}
+
+	/**
+	 * Setter for header size
+	 *
+	 * @param	$headerSize		Size of file header
+	 * @return	void
+	 */
+	protected final function setHeaderSize ($headerSize) {
+		// Set it
+		$this->headerSize = $headerSize;
+	}
+
+	/**
+	 * Getter for seek position
+	 *
+	 * @return	$seekPosition	Current seek position (stored here in object)
+	 */
+	protected final function getSeekPosition () {
+		// Get it
+		return $this->seekPosition;
+	}
+
+	/**
+	 * Setter for seek position
+	 *
+	 * @param	$seekPosition	Current seek position (stored here in object)
+	 * @return	void
+	 */
+	protected final function setSeekPosition ($seekPosition) {
+		// And set it
+		$this->seekPosition = $seekPosition;
+	}
+
+	/**
+	 * Updates seekPosition attribute from file to avoid to much access on file.
+	 *
+	 * @return	void
+	 */
+	protected function updateSeekPosition () {
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] CALLED!', __METHOD__, __LINE__));
+
+		// Get key (= seek position)
+		$seekPosition = $this->getIteratorInstance()->key();
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] Setting seekPosition=%s', __METHOD__, __LINE__, $seekPosition));
+
+		// And set it here
+		$this->setSeekPosition($seekPosition);
+
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] EXIT!', __METHOD__, __LINE__));
+	}
+
+	/**
+	 * Checks whether the file header is initialized
+	 *
+	 * @return	$isInitialized	Whether the file header is initialized
+	 */
+	protected function isFileHeaderInitialized () {
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] CALLED!', __METHOD__, __LINE__));
+		// Default is not initialized
+		$isInitialized = FALSE;
+
+		// Is the file initialized?
+		if ($this->isFileInitialized()) {
+			// Some bytes has been written, so rewind to start of it.
+			$rewindStatus = $this->getIteratorInstance()->rewind();
+			//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] rewindStatus=%s', __METHOD__, __LINE__, $rewindStatus));
+
+			// Is the rewind() call successfull?
+			if ($rewindStatus != 1) {
+				// Something bad happened
+				self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] Could not rewind().', __METHOD__, __LINE__));
+			} // END - if
+
+			// Read file header
+			$this->readFileHeader();
+
+			// The above method does already check the header
+			$isInitialized = TRUE;
+		} // END - if
+
+		// Return result
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] isInitialized=%d - EXIT!', __METHOD__, __LINE__, intval($isInitialized)));
+		return $isInitialized;
+	}
+
+	/**
+	 * Checks whether the assigned file has been initialized
+	 *
+	 * @return	$isInitialized		Whether the file's size is zero
+	 */
+	protected function isFileInitialized () {
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] CALLED!', __METHOD__, __LINE__));
+
+		// Get it from iterator which holds the pointer instance. If FALSE is returned
+		$fileSize = $this->getIteratorInstance()->size();
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] fileSize=%s', __METHOD__, __LINE__, $fileSize));
+
+		/*
+		 * The returned file size should not be FALSE or NULL as this means
+		 * that the pointer class does not work correctly.
+		 */
+		assert(is_int($fileSize));
+
+		// Is more than 0 returned?
+		$isInitialized = ($fileSize > 0);
+
+		// Return result
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] isInitialized=%d - EXIT!', __METHOD__, __LINE__, intval($isInitialized)));
+		return $isInitialized;
+	}
+
+	/**
+	 * Creates the assigned file
+	 *
+	 * @return	void
+	 */
+	protected function createFileHeader () {
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] CALLED!', __METHOD__, __LINE__));
+		// The file's header should not be initialized here
+		assert(!$this->isFileHeaderInitialized());
+
+		// Simple flush file header which will create it.
+		$this->flushFileHeader();
+
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] EXIT!!', __METHOD__, __LINE__));
+	}
+
+	/**
+	 * Flushes the file header
+	 *
+	 * @return	void
+	 */
+	protected function flushFileHeader () {
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] CALLED!', __METHOD__, __LINE__));
+
+		// Put all informations together
+		$header = sprintf('%s%s%s%s%s%s',
+			// Magic
+			self::STACK_MAGIC,
+
+			// Separator magic<->count
+			chr(self::SEPARATOR_HEADER_DATA),
+
+			// Total entries (will be zero) and pad it to 20 chars
+			str_pad($this->dec2hex($this->getCounter()), self::LENGTH_COUNT, '0', STR_PAD_LEFT),
+
+			// Separator count<->seek position
+			chr(self::SEPARATOR_HEADER_DATA),
+
+			// Position (will be zero)
+			str_pad($this->dec2hex($this->getSeekPosition(), 2), self::LENGTH_POSITION, '0', STR_PAD_LEFT),
+
+			// Separator position<->entries
+			chr(self::SEPARATOR_HEADER_ENTRIES)
+		);
+
+		// Write it to disk (header is always at seek position 0)
+		$this->writeData(0, $header);
+
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] EXIT!', __METHOD__, __LINE__));
+	}
+
+	/**
+	 * Writes data at given position
+	 *
+	 * @param	$seekPosition	Seek position
+	 * @param	$data			Data to be written
+	 * @return	void
+	 */
+	protected function writeData ($seekPosition, $data) {
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] seekPosition=%s,data()=%s - CALLED!', __METHOD__, __LINE__, $seekPosition, strlen($data)));
+
+		// Write data at given position
+		$this->getIteratorInstance()->writeAtPosition($seekPosition, $data);
+
+		// Update seek position
+		$this->updateSeekPosition();
+
+		// Flush header
+		$this->flushHeader();
+
+		// Seek to old position
+		$this->seekToOldPosition();
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] EXIT!', __METHOD__, __LINE__));
+	}
+
+	/**
+	 * Pre-allocates file (if enabled) with some space for later faster write access.
+	 *
+	 * @param	$type	Type of the file
+	 * @return	void
+	 */
+	protected function preAllocateFile ($type) {
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] CALLED!', __METHOD__, __LINE__));
+
+		// Is it enabled?
+		if ($this->getConfigInstance()->getConfigEntry($type . '_pre_allocate_enabled') != 'Y') {
+			// Not enabled
+			self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] Not pre-allocating file.', __METHOD__, __LINE__));
+
+			// Don't continue here.
+			return;
+		} // END - if
+
+		// Message to user
+		self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] Pre-allocating file ...', __METHOD__, __LINE__));
+
+		/*
+		 * Calculate minimum length for one entry:
+		 * minimum length = hash length + separator + name + minimum entry size = ?? + 1 + 10 + 1 = ??
+		 */
+		$minLengthEntry = self::getHashLength() + strlen(self::SEPARATOR_HASH_NAME) + self::LENGTH_NAME + 1;
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] minLengthEntry=%s', __METHOD__, __LINE__, $minLengthEntry));
+
+		// Calulcate seek position
+		$seekPosition = $minLengthEntry * $this->getConfigInstance()->getConfigEntry($type . '_pre_allocate_count');
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] seekPosition=%s', __METHOD__, __LINE__, $seekPosition));
+
+		// Now simply write a NUL there. This will pre-allocate the file.
+		$this->writeData($seekPosition, chr(0));
+
+		//* NOISY-DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput(sprintf('[%s:%d:] EXIT!', __METHOD__, __LINE__));
+	}
 }
 
 // [EOF]