--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/web/lib/Zend/Memory/Container/Movable.php Fri Mar 11 15:05:35 2011 +0100
@@ -0,0 +1,297 @@
+<?php
+/**
+ * Zend Framework
+ *
+ * LICENSE
+ *
+ * This source file is subject to the new BSD license that is bundled
+ * with this package in the file LICENSE.txt.
+ * It is also available through the world-wide-web at this URL:
+ * http://framework.zend.com/license/new-bsd
+ * If you did not receive a copy of the license and are unable to
+ * obtain it through the world-wide-web, please send an email
+ * to license@zend.com so we can send you a copy immediately.
+ *
+ * @category Zend
+ * @package Zend_Memory
+ * @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license http://framework.zend.com/license/new-bsd New BSD License
+ * @version $Id: Movable.php 20096 2010-01-06 02:05:09Z bkarwin $
+ */
+
+/** Zend_Memory_Container */
+require_once 'Zend/Memory/Container.php';
+
+/** Zend_Memory_Value */
+require_once 'Zend/Memory/Value.php';
+
+/**
+ * Memory value container
+ *
+ * Movable (may be swapped with specified backend and unloaded).
+ *
+ * @category Zend
+ * @package Zend_Memory
+ * @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license http://framework.zend.com/license/new-bsd New BSD License
+ */
+class Zend_Memory_Container_Movable extends Zend_Memory_Container {
+ /**
+ * Internal object Id
+ *
+ * @var integer
+ */
+ protected $_id;
+
+ /**
+ * Memory manager reference
+ *
+ * @var Zend_Memory_Manager
+ */
+ private $_memManager;
+
+ /**
+ * Value object
+ *
+ * @var Zend_Memory_Value
+ */
+ private $_value;
+
+ /** Value states */
+ const LOADED = 1;
+ const SWAPPED = 2;
+ const LOCKED = 4;
+
+ /**
+ * Value state (LOADED/SWAPPED/LOCKED)
+ *
+ * @var integer
+ */
+ private $_state;
+
+ /**
+ * Object constructor
+ *
+ * @param Zend_Memory_Manager $memoryManager
+ * @param integer $id
+ * @param string $value
+ */
+ public function __construct(Zend_Memory_Manager $memoryManager, $id, $value)
+ {
+ $this->_memManager = $memoryManager;
+ $this->_id = $id;
+ $this->_state = self::LOADED;
+ $this->_value = new Zend_Memory_Value($value, $this);
+ }
+
+ /**
+ * Lock object in memory.
+ */
+ public function lock()
+ {
+ if ( !($this->_state & self::LOADED) ) {
+ $this->_memManager->load($this, $this->_id);
+ $this->_state |= self::LOADED;
+ }
+
+ $this->_state |= self::LOCKED;
+
+ /**
+ * @todo
+ * It's possible to set "value" container attribute to avoid modification tracing, while it's locked
+ * Check, if it's more effective
+ */
+ }
+
+ /**
+ * Unlock object
+ */
+ public function unlock()
+ {
+ // Clear LOCKED state bit
+ $this->_state &= ~self::LOCKED;
+ }
+
+ /**
+ * Return true if object is locked
+ *
+ * @return boolean
+ */
+ public function isLocked()
+ {
+ return $this->_state & self::LOCKED;
+ }
+
+ /**
+ * Get handler
+ *
+ * Loads object if necessary and moves it to the top of loaded objects list.
+ * Swaps objects from the bottom of loaded objects list, if necessary.
+ *
+ * @param string $property
+ * @return string
+ * @throws Zend_Memory_Exception
+ */
+ public function __get($property)
+ {
+ if ($property != 'value') {
+ require_once 'Zend/Memory/Exception.php';
+ throw new Zend_Memory_Exception('Unknown property: Zend_Memory_container::$' . $property);
+ }
+
+ if ( !($this->_state & self::LOADED) ) {
+ $this->_memManager->load($this, $this->_id);
+ $this->_state |= self::LOADED;
+ }
+
+ return $this->_value;
+ }
+
+ /**
+ * Set handler
+ *
+ * @param string $property
+ * @param string $value
+ * @throws Zend_Exception
+ */
+ public function __set($property, $value)
+ {
+ if ($property != 'value') {
+ require_once 'Zend/Memory/Exception.php';
+ throw new Zend_Memory_Exception('Unknown property: Zend_Memory_container::$' . $property);
+ }
+
+ $this->_state = self::LOADED;
+ $this->_value = new Zend_Memory_Value($value, $this);
+
+ $this->_memManager->processUpdate($this, $this->_id);
+ }
+
+
+ /**
+ * Get string value reference
+ *
+ * _Must_ be used for value access before PHP v 5.2
+ * or _may_ be used for performance considerations
+ *
+ * @return &string
+ */
+ public function &getRef()
+ {
+ if ( !($this->_state & self::LOADED) ) {
+ $this->_memManager->load($this, $this->_id);
+ $this->_state |= self::LOADED;
+ }
+
+ return $this->_value->getRef();
+ }
+
+ /**
+ * Signal, that value is updated by external code.
+ *
+ * Should be used together with getRef()
+ */
+ public function touch()
+ {
+ $this->_memManager->processUpdate($this, $this->_id);
+ }
+
+ /**
+ * Process container value update.
+ * Must be called only by value object
+ *
+ * @internal
+ */
+ public function processUpdate()
+ {
+ // Clear SWAPPED state bit
+ $this->_state &= ~self::SWAPPED;
+
+ $this->_memManager->processUpdate($this, $this->_id);
+ }
+
+ /**
+ * Start modifications trace
+ *
+ * @internal
+ */
+ public function startTrace()
+ {
+ if ( !($this->_state & self::LOADED) ) {
+ $this->_memManager->load($this, $this->_id);
+ $this->_state |= self::LOADED;
+ }
+
+ $this->_value->startTrace();
+ }
+
+ /**
+ * Set value (used by memory manager when value is loaded)
+ *
+ * @internal
+ */
+ public function setValue($value)
+ {
+ $this->_value = new Zend_Memory_Value($value, $this);
+ }
+
+ /**
+ * Clear value (used by memory manager when value is swapped)
+ *
+ * @internal
+ */
+ public function unloadValue()
+ {
+ // Clear LOADED state bit
+ $this->_state &= ~self::LOADED;
+
+ $this->_value = null;
+ }
+
+ /**
+ * Mark, that object is swapped
+ *
+ * @internal
+ */
+ public function markAsSwapped()
+ {
+ // Clear LOADED state bit
+ $this->_state |= self::LOADED;
+ }
+
+ /**
+ * Check if object is marked as swapped
+ *
+ * @internal
+ * @return boolean
+ */
+ public function isSwapped()
+ {
+ return $this->_state & self::SWAPPED;
+ }
+
+ /**
+ * Get object id
+ *
+ * @internal
+ * @return integer
+ */
+ public function getId()
+ {
+ return $this->_id;
+ }
+ /**
+ * Destroy memory container and remove it from memory manager list
+ *
+ * @internal
+ */
+ public function destroy()
+ {
+ /**
+ * We don't clean up swap because of performance considerations
+ * Cleaning is performed by Memory Manager destructor
+ */
+
+ $this->_memManager->unlink($this, $this->_id);
+ }
+}