mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/Echo
synced 2024-12-20 19:53:09 +00:00
7e5eceb5a6
Changes to the use statements done automatically via script Change-Id: Iab065a2005acccfe05cc827fdafc7861687d053d
81 lines
2 KiB
PHP
81 lines
2 KiB
PHP
<?php
|
|
|
|
namespace MediaWiki\Extension\Notifications;
|
|
|
|
use UnexpectedValueException;
|
|
use Wikimedia\ObjectCache\WANObjectCache;
|
|
|
|
/**
|
|
* Caches an ContainmentList within WANObjectCache to prevent needing
|
|
* to load the nested list from a potentially slow source (mysql, etc).
|
|
*/
|
|
class CachedList implements ContainmentList {
|
|
private const ONE_WEEK = 4233600;
|
|
|
|
/** @var WANObjectCache */
|
|
protected $cache;
|
|
/** @var string */
|
|
protected $partialCacheKey;
|
|
/** @var ContainmentList */
|
|
protected $nestedList;
|
|
/** @var int */
|
|
protected $timeout;
|
|
/** @var string[]|null */
|
|
private $result;
|
|
|
|
/**
|
|
* @param WANObjectCache $cache Bag to stored cached data in.
|
|
* @param string $partialCacheKey Partial cache key, $nestedList->getCacheKey() will be appended
|
|
* to this to construct the cache key used.
|
|
* @param ContainmentList $nestedList The nested EchoContainmentList to cache the result of.
|
|
* @param int $timeout How long in seconds to cache the nested list, defaults to 1 week.
|
|
*/
|
|
public function __construct(
|
|
WANObjectCache $cache,
|
|
$partialCacheKey,
|
|
ContainmentList $nestedList,
|
|
$timeout = self::ONE_WEEK
|
|
) {
|
|
$this->cache = $cache;
|
|
$this->partialCacheKey = $partialCacheKey;
|
|
$this->nestedList = $nestedList;
|
|
$this->timeout = $timeout;
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function getValues() {
|
|
if ( $this->result ) {
|
|
return $this->result;
|
|
}
|
|
$this->result = $this->cache->getWithSetCallback(
|
|
$this->getCacheKey(),
|
|
$this->timeout,
|
|
function () {
|
|
$result = $this->nestedList->getValues();
|
|
if ( !is_array( $result ) ) {
|
|
throw new UnexpectedValueException( sprintf(
|
|
"Expected array but received '%s' from '%s::getValues'",
|
|
get_debug_type( $result ),
|
|
get_class( $this->nestedList )
|
|
) );
|
|
}
|
|
return $result;
|
|
}
|
|
);
|
|
return $this->result;
|
|
}
|
|
|
|
/**
|
|
* @inheritDoc
|
|
*/
|
|
public function getCacheKey() {
|
|
return $this->cache->makeGlobalKey(
|
|
'echo-containment-list',
|
|
$this->partialCacheKey,
|
|
$this->nestedList->getCacheKey()
|
|
);
|
|
}
|
|
}
|