X-Git-Url: https://git.mxchange.org/?p=core.git;a=blobdiff_plain;f=inc%2Fclasses%2Fmain%2Fclass_BaseFrameworkSystem.php;h=6ac52f82b794b8afbb0fe68fa1e507f053bb6053;hp=85dd986a4e0a2626a95d26028876518c01b9184e;hb=b1e0d7fa2879431e8b2dd17eb00aa7968f3c83a7;hpb=f62f440da8b0f369da1879913202755f6d06559a

diff --git a/inc/classes/main/class_BaseFrameworkSystem.php b/inc/classes/main/class_BaseFrameworkSystem.php
index 85dd986a..6ac52f82 100644
--- a/inc/classes/main/class_BaseFrameworkSystem.php
+++ b/inc/classes/main/class_BaseFrameworkSystem.php
@@ -134,15 +134,40 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	private $helperInstance = null;
 
 	/**
-	 * An instance of a source
+	 * An instance of a Sourceable class
 	 */
 	private $sourceInstance = null;
 
+	/**
+	 * An instance of a InputStreamable class
+	 */
+	private $inputStreamInstance = null;
+
+	/**
+	 * An instance of a OutputStreamable class
+	 */
+	private $outputStreamInstance = null;
+
+	/**
+	 * Networkable handler instance
+	 */
+	private $handlerInstance = null;
+
+	/**
+	 * Visitor handler instance
+	 */
+	private $visitorInstance = null;
+
 	/**
 	 * The real class name
 	 */
 	private $realClass = 'BaseFrameworkSystem';
 
+	/**
+	 * An instance of a database wrapper class
+	 */
+	private $wrapperInstance = null;
+
 	/**
 	 * Thousands seperator
 	 */
@@ -166,6 +191,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	/***********************
 	 * Exception codes.... *
 	 ***********************/
+
 	// @todo Try to clean these constants up
 	const EXCEPTION_IS_NULL_POINTER              = 0x001;
 	const EXCEPTION_IS_NO_OBJECT                 = 0x002;
@@ -212,6 +238,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	const EXCEPTION_ATTRIBUTES_ARE_MISSING       = 0x02b;
 	const EXCEPTION_ARRAY_ELEMENTS_MISSING       = 0x02c;
 	const EXCEPTION_TEMPLATE_ENGINE_UNSUPPORTED  = 0x02d;
+	const EXCEPTION_UNSPPORTED_OPERATION         = 0x02e;
 	const EXCEPTION_MISSING_ELEMENT              = 0x030;
 	const EXCEPTION_HEADERS_ALREADY_SENT         = 0x031;
 	const EXCEPTION_DEFAULT_CONTROLLER_GONE      = 0x032;
@@ -224,6 +251,46 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	const EXCEPTION_DATABASE_UPDATED_NOT_ALLOWED = 0x039;
 	const EXCEPTION_FILTER_CHAIN_INTERCEPTED     = 0x040;
 
+	// Hexadecimal->Decimal translation array
+	private static $hexdec = array(
+		'0' => 0,
+		'1' => 1,
+		'2' => 2,
+		'3' => 3,
+		'4' => 4,
+		'5' => 5,
+		'6' => 6,
+		'7' => 7,
+		'8' => 8,
+		'9' => 9,
+		'a' => 10,
+		'b' => 11,
+		'c' => 12,
+		'd' => 13,
+		'e' => 14,
+		'f' => 15
+	);
+
+	// Decimal->hexadecimal translation array
+	private static $dechex = array(
+		 0 => '0',
+		 1 => '1',
+		 2 => '2',
+		 3 => '3',
+		 4 => '4',
+		 5 => '5',
+		 6 => '6',
+		 7 => '7',
+		 8 => '8',
+		 9 => '9',
+		10 => 'a',
+		11 => 'b',
+		12 => 'c',
+		13 => 'd',
+		14 => 'e',
+		15 => 'f'
+	);
+
 	/**
 	 * Protected super constructor
 	 *
@@ -1311,8 +1378,8 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 			// Get current time and add idle time
 			$sleepUntil = $this->getMilliTime() + abs($milliSeconds) / 1000;
 
-			// New PHP 5.1.0 function found
-			$hasSlept = time_sleep_until($sleepUntil);
+			// New PHP 5.1.0 function found, ignore errors
+			$hasSlept = @time_sleep_until($sleepUntil);
 		} else {
 			// My Sun Station doesn't have that function even with latest PHP
 			// package. :(
@@ -1526,12 +1593,88 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	/**
 	 * Getter for a Sourceable instance
 	 *
-	 * @param	$sourceInstance	The Sourceable instance
+	 * @return	$sourceInstance	The Sourceable instance
 	 */
 	protected final function getSourceInstance () {
 		return $this->sourceInstance;
 	}
 
+	/**
+	 * Getter for a InputStreamable instance
+	 *
+	 * @param	$inputStreamInstance	The InputStreamable instance
+	 */
+	protected final function getInputStreamInstance () {
+		return $this->inputStreamInstance;
+	}
+
+	/**
+	 * Setter for a InputStreamable instance
+	 *
+	 * @param	$inputStreamInstance	The InputStreamable instance
+	 * @return	void
+	 */
+	protected final function setInputStreamInstance (InputStreamable $inputStreamInstance) {
+		$this->inputStreamInstance = $inputStreamInstance;
+	}
+
+	/**
+	 * Getter for a OutputStreamable instance
+	 *
+	 * @param	$outputStreamInstance	The OutputStreamable instance
+	 */
+	protected final function getOutputStreamInstance () {
+		return $this->outputStreamInstance;
+	}
+
+	/**
+	 * Setter for a OutputStreamable instance
+	 *
+	 * @param	$outputStreamInstance	The OutputStreamable instance
+	 * @return	void
+	 */
+	protected final function setOutputStreamInstance (OutputStreamable $outputStreamInstance) {
+		$this->outputStreamInstance = $outputStreamInstance;
+	}
+
+	/**
+	 * Setter for handler instance
+	 *
+	 * @param	$handlerInstance	A Networkable instance
+	 * @return	void
+	 */
+	protected final function setHandlerInstance (Networkable $handlerInstance) {
+		$this->handlerInstance = $handlerInstance;
+	}
+
+	/**
+	 * Getter for handler instance
+	 *
+	 * @return	$handlerInstance	A Networkable instance
+	 */
+	protected final function getHandlerInstance () {
+		return $this->handlerInstance;
+	}
+
+	/**
+	 * Setter for visitor instance
+	 *
+	 * @param	$visitorInstance	A Visitor instance
+	 * @return	void
+	 */
+	protected final function setVisitorInstance (Visitor $visitorInstance) {
+		$this->visitorInstance = $visitorInstance;
+	}
+
+	/**
+	 * Getter for visitor instance
+	 *
+	 * @return	$visitorInstance	A Visitor instance
+	 */
+	protected final function getVisitorInstance () {
+		return $this->visitorInstance;
+	}
+
 	/**
 	 * Setter for raw package Data
 	 *
@@ -1550,6 +1693,191 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface {
 	public function getPackageData () {
 		return $this->packageData;
 	}
+
+	/**
+	 * Converts a hexadecimal string, even with negative sign as first string to
+	 * a decimal number using BC functions.
+	 *
+	 * This work is based on comment #86673 on php.net documentation page at:
+	 * <http://de.php.net/manual/en/function.dechex.php#86673>
+	 *
+	 * @param	$hex	Hexadecimal string
+	 * @return	$dec	Decimal number
+	 */
+	protected function hex2dec ($hex) {
+		// Convert to all lower-case
+		$hex = strtolower($hex);
+
+		// Detect sign (negative/positive numbers)
+		$sign = '';
+		if (substr($hex, 0, 1) == '-') {
+			$sign = '-';
+			$hex = substr($hex, 1);
+		} // END - if
+
+		// Decode the hexadecimal string into a decimal number
+		$dec = 0;
+		for ($i = strlen($hex) - 1, $e = 1; $i >= 0; $i--, $e = bcmul($e, 16)) {
+			$factor = self::$hexdec[substr($hex, $i, 1)];
+			$dec = bcadd($dec, bcmul($factor, $e));
+		} // END - for
+
+		// Return the decimal number
+		return $sign . $dec;
+	}
+
+	/**
+	 * Converts even very large decimal numbers, also with negative sign, 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>
+	 *
+	 * @param	$dec		Decimal number, even with negative sign
+	 * @param	$maxLength	Optional maximum length of the string
+	 * @return	$hex	Hexadecimal string
+	 */
+	protected function dec2hex ($dec, $maxLength = 0) {
+		// maxLength can be zero or devideable by 2
+		assert(($maxLength == 0) || (($maxLength % 2) == 0));
+
+		// Detect sign (negative/positive numbers)
+		$sign = '';
+		if ($dec < 0) {
+			$sign = '-';
+			$dec = abs($dec);
+		} // END - if
+
+		// Encode the decimal number into a hexadecimal string
+		$hex = '';
+		do {
+			$hex = self::$dechex[($dec % 16)] . $hex;
+			$dec /= 16;
+		} while ($dec >= 1);
+
+		/*
+		 * We need hexadecimal strings with leading zeros if the length cannot
+		 * be divided by 2
+		 */
+		if ($maxLength > 0) {
+			// Prepend more zeros
+			$hex = $this->prependStringToString($hex, '0', $maxLength);
+		} elseif ((strlen($hex) % 2) != 0) {
+			$hex = '0' . $hex;
+		}
+
+		// Return the hexadecimal string
+		return $sign . $hex;
+	}
+
+	/**
+	 * Converts a ASCII string (0 to 255) into a decimal number.
+	 *
+	 * @param	$asc	The ASCII string to be converted
+	 * @return	$dec	Decimal number
+	 */
+	protected function asc2dec ($asc) {
+		// Convert it into a hexadecimal number
+		$hex = bin2hex($asc);
+
+		// And back into a decimal number
+		$dec = $this->hex2dec($hex);
+
+		// Return it
+		return $dec;
+	}
+
+	/**
+	 * Converts a decimal number into an ASCII string.
+	 *
+	 * @param	$dec		Decimal number
+	 * @return	$asc	An ASCII string
+	 */
+	protected function dec2asc ($dec) {
+		// First convert the number into a hexadecimal string
+		$hex = $this->dec2hex($dec);
+
+		// Then convert it into the ASCII string
+		$asc = $this->hex2asc($hex);
+
+		// Return it
+		return $asc;
+	}
+
+	/**
+	 * Converts a hexadecimal number into an ASCII string. Negative numbers
+	 * are not allowed.
+	 *
+	 * @param	$hex	Hexadecimal string
+	 * @return	$asc	An ASCII string
+	 */
+	protected function hex2asc ($hex) {
+		// Check for length, it must be devideable by 2
+		//* DEBUG: */ $this->debugOutput('hex='.$hex);
+		assert((strlen($hex) % 2) == 0);
+
+		// Walk the string
+		$asc = '';
+		for ($idx = 0; $idx < strlen($hex); $idx+=2) {
+			// Get the decimal number of the chunk
+			$part = hexdec(substr($hex, $idx, 2));
+
+			// Add it to the final string
+			$asc .= chr($part);
+		} // END - for
+
+		// Return the final string
+		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: */ $this->debugOutput('prepend('.strlen($prepend).')='.$prepend.',diff='.$diff.',length='.$length);
+
+			// Construct the final prepended string
+			$strFinal = $prepend . $str;
+		} // END - if
+
+		// Return it
+		return $strFinal;
+	}
+
+	/**
+	 * Checks wether the given encoded data was encoded with Base64
+	 *
+	 * @param	$encodedData	Encoded data we shall check
+	 * @return	$isBase64		Wether the encoded data is Base64
+	 */
+	protected function isBase64Encoded ($encodedData) {
+		// Determine it
+		$isBase64 = (@base64_decode($encodedData, true) !== false);
+
+		// Return it
+		return $isBase64;
+	}
 }
 
 // [EOF]