X-Git-Url: https://git.mxchange.org/?p=core.git;a=blobdiff_plain;f=inc%2Fclasses%2Fmain%2Fclass_BaseFrameworkSystem.php;h=217920972cee11886751fead79aae0ede6f89997;hp=502ee84a7ec6eab5fb964c6eaa0b7d599978c11e;hb=3082d3f331e7181f607ca02dae7cd0e54ddeef5a;hpb=2e80331da79b13c3094f9039d4c584e3e4b89894

diff --git a/inc/classes/main/class_BaseFrameworkSystem.php b/inc/classes/main/class_BaseFrameworkSystem.php
index 502ee84a..21792097 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;
 
@@ -173,6 +183,16 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	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
 	 */
@@ -198,6 +218,41 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	 */
 	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.... *
 	 ***********************/
@@ -249,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;
@@ -259,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
@@ -355,6 +411,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		} else {
 			// Do not call this twice
 			trigger_error(__METHOD__ . ': Called twice.');
+			exit;
 		}
 	}
 
@@ -455,7 +512,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		$this->debugBackTrace(sprintf('Tried to set a missing field. name=%s, value[%s]=%s',
 			$name,
 			gettype($value),
-			$value
+			print_r($value, TRUE)
 		));
 	}
 
@@ -1083,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;
 	}
 
@@ -1216,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
@@ -1410,6 +1505,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		} else {
 			// Trigger an error
 			trigger_error($stubMessage);
+			exit;
 		}
 	}
 
@@ -1444,20 +1540,29 @@ 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;
@@ -1775,6 +1880,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 			} else {
 				// Trigger an error
 				trigger_error($message . "<br />\n");
+				exit;
 			}
 		} else {
 			// @TODO Finish this part!
@@ -2017,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)
 		);
@@ -2053,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).
 	 *
@@ -2198,6 +2322,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		if (!$this->isGenericArrayGroupSet($keyGroup, $subGroup)) {
 			// No, then abort here
 			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ' not found.');
+			exit;
 		} // END - if
 
 		// Debug message
@@ -2304,6 +2429,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		if (($forceInit === FALSE) && ($this->isGenericArrayGroupSet($keyGroup, $subGroup))) {
 			// Already initialized
 			trigger_error(__METHOD__ . ':keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ' already initialized.');
+			exit;
 		} // END - if
 
 		// Initialize it
@@ -2327,6 +2453,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		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
@@ -2351,6 +2478,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		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
@@ -2430,6 +2558,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		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
@@ -2457,6 +2586,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		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
@@ -2482,6 +2612,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		if (!isset($this->genericArray[$keyGroup])) {
 			// Abort here
 			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ' not found.');
+			exit;
 		} // END - if
 
 		// Then count it
@@ -2509,6 +2640,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		if (!$this->isGenericArrayGroupSet($keyGroup, $subGroup)) {
 			// Abort here
 			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ',subGroup=' . $subGroup . ' not found.');
+			exit;
 		} // END - if
 
 		// Then count it
@@ -2537,9 +2669,11 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		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
@@ -2566,6 +2700,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		if (!isset($this->genericArray[$keyGroup])) {
 			// Then abort here
 			trigger_error(__METHOD__ . ': keyGroup=' . $keyGroup . ' does not exist.');
+			exit;
 		} // END - if
 
 		// Return it
@@ -2605,6 +2740,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		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
@@ -2646,6 +2782,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		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
@@ -2688,6 +2825,273 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 		// 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 () {
+		// Is the method there?
+		assert(is_callable(array($this, 'readFileHeader')));
+
+		//* 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__));
+	}
+
+	/**
+	 * 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]