X-Git-Url: https://git.mxchange.org/?p=core.git;a=blobdiff_plain;f=inc%2Fclasses%2Fmain%2Fclass_BaseFrameworkSystem.php;h=9c1cf4ca8ce05f6277bb79c3bf323a92de74a010;hp=c5b4ebe06a81c7077c2046dc99c9e3d0c00f3a9a;hb=33779a34a2a112c3a9a2447ed0a17d296c49b244;hpb=c57e393c7b663704100ed4d6aab08eceebe09088 diff --git a/inc/classes/main/class_BaseFrameworkSystem.php b/inc/classes/main/class_BaseFrameworkSystem.php index c5b4ebe0..9c1cf4ca 100644 --- a/inc/classes/main/class_BaseFrameworkSystem.php +++ b/inc/classes/main/class_BaseFrameworkSystem.php @@ -134,15 +134,35 @@ 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; + /** * The real class name */ private $realClass = 'BaseFrameworkSystem'; + /** + * An instance of a database wrapper class + */ + private $wrapperInstance = null; + /** * Thousands seperator */ @@ -166,6 +186,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; @@ -1352,8 +1373,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. :( @@ -1565,12 +1586,60 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface { } /** - * Getter for a Sourceable instance + * Getter for a InputStreamable instance * - * @param $sourceInstance The Sourceable instance + * @param $inputStreamInstance The InputStreamable instance */ - protected final function getSourceInstance () { - return $this->sourceInstance; + 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; } /** @@ -1602,7 +1671,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface { * @param $hex Hexadecimal string * @return $dec Decimal number */ - public final function hex2dec ($hex) { + protected function hex2dec ($hex) { // Convert to all lower-case $hex = strtolower($hex); @@ -1631,10 +1700,14 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface { * This work is based on comment #97756 on php.net documentation page at: * * - * @param $dec Decimal number, even with negative sign + * @param $dec Decimal number, even with negative sign + * @param $maxLength Optional maximum length of the string * @return $hex Hexadecimal string */ - public final function dec2hex ($dec) { + 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) { @@ -1649,6 +1722,17 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface { $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; } @@ -1659,7 +1743,7 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface { * @param $asc The ASCII string to be converted * @return $dec Decimal number */ - public final function asc2dec ($asc) { + protected function asc2dec ($asc) { // Convert it into a hexadecimal number $hex = bin2hex($asc); @@ -1673,12 +1757,12 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface { /** * Converts a decimal number into an ASCII string. * - * @param $dec Decimal number + * @param $dec Decimal number * @return $asc An ASCII string */ - public final function dec2asc ($deg) { + protected function dec2asc ($dec) { // First convert the number into a hexadecimal string - $hex = $this->dec2hex($deg); + $hex = $this->dec2hex($dec); // Then convert it into the ASCII string $asc = $this->hex2asc($hex); @@ -1694,8 +1778,9 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface { * @param $hex Hexadecimal string * @return $asc An ASCII string */ - public final function hex2asc ($hex) { + 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 @@ -1703,7 +1788,6 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface { for ($idx = 0; $idx < strlen($hex); $idx+=2) { // Get the decimal number of the chunk $part = hexdec(substr($hex, $idx, 2)); - $this->debugOutput(__FUNCTION__ . ': part(' . strlen($part) . ')=' . $part); // Add it to the final string $asc .= chr($part); @@ -1712,6 +1796,55 @@ class BaseFrameworkSystem extends stdClass implements FrameworkInterface { // 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]