You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

90 lines
2.9 KiB

13 years ago
<?php
/**
* @link http://www.yiiframework.com/
* @copyright Copyright (c) 2008 Yii Software LLC
13 years ago
* @license http://www.yiiframework.com/license/
*/
namespace yii\caching;
13 years ago
/**
13 years ago
* ChainedDependency represents a dependency which is composed of a list of other dependencies.
13 years ago
*
13 years ago
* When [[dependOnAll]] is true, if any of the dependencies has changed, this dependency is
* considered changed; When [[dependOnAll]] is false, if one of the dependencies has NOT changed,
* this dependency is considered NOT changed.
13 years ago
*
* @property boolean $hasChanged Whether the dependency is changed or not.
*
* @author Qiang Xue <qiang.xue@gmail.com>
* @since 2.0
13 years ago
*/
13 years ago
class ChainedDependency extends Dependency
13 years ago
{
/**
* @var Dependency[] list of dependencies that this dependency is composed of.
* Each array element must be a dependency object.
13 years ago
*/
public $dependencies;
13 years ago
/**
* @var boolean whether this dependency is depending on every dependency in [[dependencies]].
* Defaults to true, meaning if any of the dependencies has changed, this dependency is considered changed.
* When it is set false, it means if one of the dependencies has NOT changed, this dependency
* is considered NOT changed.
*/
public $dependOnAll = true;
13 years ago
/**
13 years ago
* Constructor.
* @param Dependency[] $dependencies list of dependencies that this dependency is composed of.
* Each array element should be a dependency object.
* @param array $config name-value pairs that will be used to initialize the object properties
13 years ago
*/
public function __construct($dependencies = array(), $config = array())
13 years ago
{
13 years ago
$this->dependencies = $dependencies;
parent::__construct($config);
13 years ago
}
/**
13 years ago
* Evaluates the dependency by generating and saving the data related with dependency.
* @param Cache $cache the cache component that is currently evaluating this dependency
13 years ago
*/
public function evaluateDependency($cache)
13 years ago
{
13 years ago
foreach ($this->dependencies as $dependency) {
$dependency->evaluateDependency($cache);
13 years ago
}
}
/**
13 years ago
* Generates the data needed to determine if dependency has been changed.
* This method does nothing in this class.
* @param Cache $cache the cache component that is currently evaluating this dependency
13 years ago
* @return mixed the data needed to determine if dependency has been changed.
13 years ago
*/
protected function generateDependencyData($cache)
13 years ago
{
13 years ago
return null;
13 years ago
}
/**
* Performs the actual dependency checking.
* This method returns true if any of the dependency objects
* reports a dependency change.
* @param Cache $cache the cache component that is currently evaluating this dependency
13 years ago
* @return boolean whether the dependency is changed or not.
*/
public function getHasChanged($cache)
13 years ago
{
foreach ($this->dependencies as $dependency) {
if ($this->dependOnAll && $dependency->getHasChanged($cache)) {
13 years ago
return true;
} elseif (!$this->dependOnAll && !$dependency->getHasChanged($cache)) {
13 years ago
return false;
}
13 years ago
}
13 years ago
return !$this->dependOnAll;
13 years ago
}
}