Class: I2CE MagicData (Development)

From IHRIS Wiki
Revision as of 15:27, 10 March 2010 by Litlfred (talk | contribs) (Created page with '{{otherversions|Class: I2CE_MagicData}} This article describes the class ''I2CE_MagicData'' . *Extends the class: I2CE_MagicDataNode…')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


This article describes the class I2CE_MagicData .

Configuration class to lookup and save configuration options.

Variables

$instances

A list of named instances of this class.

$last_instance

The index of the last accessed stored instance of this class

$instance

The instance index for this configuration grouping.

$storage

A list of storage objects to use to store and retrieve values. Values will be saved using all storage objects and retrieved until a match is found in the order the objects are assigned.

$num_storage

$locales

Methods

__construct()

Construct a new configuration value or grouping.

  • Defined in i2ce/lib/I2CE_MagicData.php on line 288
  • Signature: protected function __construct($name,$parent,$check_key)
  • Parameters:
    • string $name
      The name of this configuration setting.
      • Default Value: null
    • I2CE_MagicDataNode $parent
      The parent of this configuration setting.
      • Default Value: null
    • boolean $check_key
      Defaults to true in which case we check that the key is valid.
      • Default Value: true

addStorage()

Add the given storage object to this instance. The last one added is considered to be the "definitive" one -- the one whose contents should be considered correct. The first one added should be the one which has quickest access

clearCache()

Clear caching for each of the storage mechanisms @param I2CE_MagicDataNode $node. The node we wish to remove from the cache. If null ( default) we call the clear() method for all but the last added storage mecahnism. If non-null, we call the destory() method for the node on all but the last storage mechanism.

destroy()

Destroy the specified node from each of the storage mechanisms

getPath()

Return the full path to this configuration setting.

getPermanentStorageClass()

Gets the class of the permanent storage object (the last one added)

instance()

Return an instance of this class based on the index given. This will create the instance if it doesn't exist.

  • Defined in i2ce/lib/I2CE_MagicData.php on line 67
  • Signature: static public function instance($index,$replace)
  • Parameters:
    • string $index
      • Default Value: NULL
    • boolean $replace
      Defaults to false. If true and $index is non null, then we create a new instance at $index.
      • Default Value: FALSE
  • Returns: I2CE_MagicData

pathDivider()

Return the path divider for this MagicDataNode object

retrieve()

Retrieve the given magic data node (which should be a descendent of this instance.)

setLocales()

store()

Store the given magic data node (which should be a descendent of this instance.) Starts storing at the last added storage mechanism until it reaches the first storage mechanism. If it fails saving at any storage mechanis, it will call the destroy method on that storage mechanism and any remaining one.

  • Defined in i2ce/lib/I2CE_MagicData.php on line 137
  • Signature: public function store($node,$max)
  • Parameters:
    • I2CE_MagicDataNode $node
    • integer $max
      The max index of storage objects to save. Defaults to -1 meaning we store on all mechanisms
      • Default Value: -1
  • Returns: boolean
    true on success.

tearDown()

Clean up all MagicData instances. Normally, this should not be used. Primarily for unit testing.

Inherited Methods

__get()

This public method is inherited from I2CE_MagicDataNode->__get()

__isset()

This public method is inherited from I2CE_MagicDataNode->__isset()

__set()

This public method is inherited from I2CE_MagicDataNode->__set()

__toString()

This public method is inherited from I2CE_MagicDataNode->__toString()

__unset()

This public method is inherited from I2CE_MagicDataNode->__unset()

checkKey()

This public method is inherited from I2CE_MagicDataNode->checkKey()

count()

This public method is inherited from I2CE_MagicDataNode->count()

current()

This public method is inherited from I2CE_MagicDataNode->current()

erase()

This public method is inherited from I2CE_MagicDataNode->erase()

eraseChildren()

This public method is inherited from I2CE_MagicDataNode->eraseChildren()

getAsArray()

This public method is inherited from I2CE_MagicDataNode->getAsArray()

getAttribute()

This public method is inherited from I2CE_MagicDataNode->getAttribute()

getAttributes()

This public method is inherited from I2CE_MagicDataNode->getAttributes()

getChildren()

This public method is inherited from I2CE_MagicDataNode->getChildren()

getKeys()

This public method is inherited from I2CE_MagicDataNode->getKeys()

getName()

This public method is inherited from I2CE_MagicDataNode->getName()

getParent()

This public method is inherited from I2CE_MagicDataNode->getParent()

getSaveValue()

This public method is inherited from I2CE_MagicDataNode->getSaveValue()

getTranslation()

This public method is inherited from I2CE_MagicDataNode->getTranslation()

getTranslations()

This public method is inherited from I2CE_MagicDataNode->getTranslations()

getType()

This public method is inherited from I2CE_MagicDataNode->getType()

getValue()

This public method is inherited from I2CE_MagicDataNode->getValue()

hasAttribute()

This public method is inherited from I2CE_MagicDataNode->hasAttribute()

hasChildren()

This public method is inherited from I2CE_MagicDataNode->hasChildren()

is_indeterminate()

This public method is inherited from I2CE_MagicDataNode->is_indeterminate()

is_parent()

This public method is inherited from I2CE_MagicDataNode->is_parent()

is_root()

This public method is inherited from I2CE_MagicDataNode->is_root()

is_scalar()

This public method is inherited from I2CE_MagicDataNode->is_scalar()

is_translatable()

This public method is inherited from I2CE_MagicDataNode->is_translatable()

is_translated()

This public method is inherited from I2CE_MagicDataNode->is_translated()

key()

This public method is inherited from I2CE_MagicDataNode->key()

krsort()

This public method is inherited from I2CE_MagicDataNode->krsort()

ksort()

This public method is inherited from I2CE_MagicDataNode->ksort()

next()

This public method is inherited from I2CE_MagicDataNode->next()

offsetExists()

This public method is inherited from I2CE_MagicDataNode->offsetExists()

offsetGet()

This public method is inherited from I2CE_MagicDataNode->offsetGet()

offsetSet()

This public method is inherited from I2CE_MagicDataNode->offsetSet()

offsetUnset()

This public method is inherited from I2CE_MagicDataNode->offsetUnset()

pathExists()

This public method is inherited from I2CE_MagicDataNode->pathExists()

pop()

This public method is inherited from I2CE_MagicDataNode->pop()

push()

This public method is inherited from I2CE_MagicDataNode->push()

raiseError()

This public method is inherited from I2CE_MagicDataNode->raiseError()

removeAttribute()

This public method is inherited from I2CE_MagicDataNode->removeAttribute()

removeTranslation()

This public method is inherited from I2CE_MagicDataNode->removeTranslation()

rewind()

This public method is inherited from I2CE_MagicDataNode->rewind()

setAttribute()

This public method is inherited from I2CE_MagicDataNode->setAttribute()

setIfIsSet()

This public method is inherited from I2CE_MagicDataNode->setIfIsSet()

setTranslatable()

This public method is inherited from I2CE_MagicDataNode->setTranslatable()

setTranslation()

This public method is inherited from I2CE_MagicDataNode->setTranslation()

setValue()

This public method is inherited from I2CE_MagicDataNode->setValue()

set_parent()

This public method is inherited from I2CE_MagicDataNode->set_parent()

set_scalar()

This public method is inherited from I2CE_MagicDataNode->set_scalar()

traverse()

This public method is inherited from I2CE_MagicDataNode->traverse()

uksort()

This public method is inherited from I2CE_MagicDataNode->uksort()

unpopulate()

This public method is inherited from I2CE_MagicDataNode->unpopulate()

valid()

This public method is inherited from I2CE_MagicDataNode->valid()

volatile()

This public method is inherited from I2CE_MagicDataNode->volatile()

_getAsArray()

This protected method is inherited from I2CE_MagicDataNode->_getAsArray()

_getAttribute()

This protected method is inherited from I2CE_MagicDataNode->_getAttribute()

_getAttributes()

This protected method is inherited from I2CE_MagicDataNode->_getAttributes()

_hasAttribute()

This protected method is inherited from I2CE_MagicDataNode->_hasAttribute()

_removeAttribute()

This protected method is inherited from I2CE_MagicDataNode->_removeAttribute()

_setAttribute()

This protected method is inherited from I2CE_MagicDataNode->_setAttribute()

is_populated()

This protected method is inherited from I2CE_MagicDataNode->is_populated()

newAttribute()

This protected method is inherited from I2CE_MagicDataNode->newAttribute()

newChild()

This protected method is inherited from I2CE_MagicDataNode->newChild()

populate()

This protected method is inherited from I2CE_MagicDataNode->populate()

save()

This protected method is inherited from I2CE_MagicDataNode->save()

setType()

This protected method is inherited from I2CE_MagicDataNode->setType()

Inherited Variables

$type

Theis protected variable is inherited from I2CE_MagicDataNode->$type

$name

Theis protected variable is inherited from I2CE_MagicDataNode->$name

$value

Theis protected variable is inherited from I2CE_MagicDataNode->$value

$children

Theis protected variable is inherited from I2CE_MagicDataNode->$children

$parent

Theis protected variable is inherited from I2CE_MagicDataNode->$parent

$parentPath

Theis protected variable is inherited from I2CE_MagicDataNode->$parentPath

$parentPathTop

Theis protected variable is inherited from I2CE_MagicDataNode->$parentPathTop

$top

Theis protected variable is inherited from I2CE_MagicDataNode->$top

$volatile

Theis protected variable is inherited from I2CE_MagicDataNode->$volatile

$attributes

Theis protected variable is inherited from I2CE_MagicDataNode->$attributes