summaryrefslogtreecommitdiff
path: root/framework/Configuration/Provider
diff options
context:
space:
mode:
Diffstat (limited to 'framework/Configuration/Provider')
-rw-r--r--framework/Configuration/Provider/TProviderBase.php80
1 files changed, 72 insertions, 8 deletions
diff --git a/framework/Configuration/Provider/TProviderBase.php b/framework/Configuration/Provider/TProviderBase.php
index 2d44bf39..7c5ffbb8 100644
--- a/framework/Configuration/Provider/TProviderBase.php
+++ b/framework/Configuration/Provider/TProviderBase.php
@@ -8,29 +8,51 @@
* @package System.Configuration.Provider
* @since 3.1
*/
-abstract class TProviderBase
+abstract class TProviderBase extends TModule
{
- private $_Description;
- private $_Initialized = false;
+ private $_description;
+ private $_initialized = false;
private $_name;
+ private $_applicationName;
+ private $_enabled=false;
public function __construct(){}
public function getDescription()
{
- return $this->_Description;
+ return $this->_description;
+ }
+ public function setDescription($value)
+ {
+ $this->_description = TPropertyValue::ensureString($value);
}
public function getName()
{
return $this->_name;
}
- public function Initialize($name,$config)
+ public function getApplicationName()
+ {
+ return $this->_applicationName;
+ }
+ public function setApplicationName($value)
+ {
+ $this->_applicationName = TPropertyValue::ensureString($value);
+ }
+ public function getEnabled()
{
- if ($this->_Initialized)
+ return $this->_enabled;
+ }
+ public function setEnabled($value)
+ {
+ $this->_enabled = TPropertyValue::ensureBoolean($value);
+ }
+ public function initialize($name,$config)
+ {
+ if ($this->_initialized)
{
throw new TProviderException('Provider_Already_Initialized');
}
- $this->_Initialized=true;
+ $this->_initialized=true;
if ($name === null)
{
@@ -46,9 +68,51 @@ abstract class TProviderBase
if ($config !== null && is_array($config))
{
- $this->_Description = TPropertyValue::ensureString($config['description']);
+ $this->_description = TPropertyValue::ensureString($config['description']);
unset($config['description']);
}
}
+ /**
+ * Generates a Universally Unique IDentifier, version 4.
+ *
+ * RFC 4122 (http://www.ietf.org/rfc/rfc4122.txt) defines a special type of Globally
+ * Unique IDentifiers (GUID), as well as several methods for producing them. One
+ * such method, described in section 4.4, is based on truly random or pseudo-random
+ * number generators, and is therefore implementable in a language like PHP.
+ *
+ * We choose to produce pseudo-random numbers with the Mersenne Twister, and to always
+ * limit single generated numbers to 16 bits (ie. the decimal value 65535). That is
+ * because, even on 32-bit systems, PHP's RAND_MAX will often be the maximum *signed*
+ * value, with only the equivalent of 31 significant bits. Producing two 16-bit random
+ * numbers to make up a 32-bit one is less efficient, but guarantees that all 32 bits
+ * are random.
+ *
+ * The algorithm for version 4 UUIDs (ie. those based on random number generators)
+ * states that all 128 bits separated into the various fields (32 bits, 16 bits, 16 bits,
+ * 8 bits and 8 bits, 48 bits) should be random, except : (a) the version number should
+ * be the last 4 bits in the 3rd field, and (b) bits 6 and 7 of the 4th field should
+ * be 01. We try to conform to that definition as efficiently as possible, generating
+ * smaller values where possible, and minimizing the number of base conversions.
+ *
+ * @copyright Copyright (c) CFD Labs, 2006. This function may be used freely for
+ * any purpose ; it is distributed without any form of warranty whatsoever.
+ * @author David Holmes <dholmes@cfdsoftware.net>
+ *
+ * @return string A UUID, made up of 32 hex digits and 4 hyphens.
+ */
+ public function generateUuid()
+ {
+ // The field names refer to RFC 4122 section 4.1.2
+ return sprintf('%04x%04x-%04x-%03x4-%04x-%04x%04x%04x',
+ mt_rand(0, 65535), mt_rand(0, 65535), // 32 bits for "time_low"
+ mt_rand(0, 65535), // 16 bits for "time_mid"
+ mt_rand(0, 4095), // 12 bits before the 0100 of (version) 4 for "time_hi_and_version"
+ bindec(substr_replace(sprintf('%016b', mt_rand(0, 65535)), '01', 6, 2)),
+ // 8 bits, the last two of which (positions 6 and 7) are 01, for "clk_seq_hi_res"
+ // (hence, the 2nd hex digit after the 3rd hyphen can only be 1, 5, 9 or d)
+ // 8 bits for "clk_seq_low"
+ mt_rand(0, 65535), mt_rand(0, 65535), mt_rand(0, 65535) // 48 bits for "node"
+ );
+ }
}
?> \ No newline at end of file