class IconCollector
A CacheCollector implementation for building icons info.
Hierarchy
- class \Drupal\Core\Cache\CacheCollector implements \Drupal\Core\Cache\CacheCollectorInterface, \Drupal\Core\DestructableInterface
- class \Drupal\Core\Theme\Icon\IconCollector extends \Drupal\Core\Cache\CacheCollector
Expanded class hierarchy of IconCollector
1 file declares its use of IconCollector
- IconPackManager.php in core/
lib/ Drupal/ Core/ Theme/ Icon/ Plugin/ IconPackManager.php
File
-
core/
lib/ Drupal/ Core/ Theme/ Icon/ IconCollector.php, line 14
Namespace
Drupal\Core\Theme\IconView source
class IconCollector extends CacheCollector {
/**
* Constructs a IconCollector instance.
*
* @param \Drupal\Core\Theme\Icon\IconExtractorPluginManager $iconPackExtractorManager
* The icon plugin extractor service.
* @param \Drupal\Core\Cache\CacheBackendInterface $cache
* The cache backend.
* @param \Drupal\Core\Lock\LockBackendInterface $lock
* The lock backend.
*/
public function __construct(IconExtractorPluginManager $iconPackExtractorManager, CacheBackendInterface $cache, LockBackendInterface $lock) {
parent::__construct('icon_info', $cache, $lock, [
'icon_pack_collector',
]);
}
/**
* {@inheritdoc}
*/
public function set($key, $value) : void {
$this->lazyLoadCache();
$this->storage[$key] = $value;
$this->persist($key);
// Chances are very small but the key might have been marked for deletion.
unset($this->keysToRemove[$key]);
}
/**
* {@inheritdoc}
*/
public function get($key, array $definition = []) : ?IconDefinitionInterface {
$this->lazyLoadCache();
if (\array_key_exists($key, $this->storage)) {
return $this->storage[$key];
}
else {
return $this->resolveCacheMiss($key, $definition);
}
}
/**
* {@inheritdoc}
*/
public function resolveCacheMiss($key, array $definition = []) : ?IconDefinitionInterface {
$icon = $this->getIconFromExtractor($key, $definition);
$this->storage[$key] = $icon;
$this->persist($key);
return $icon;
}
/**
* Returns the icon from an icon id and icon pack definition.
*
* @param string $icon_full_id
* The icon full id as pack_id:icon_id.
* @param array $definitions
* The icon pack definitions.
*
* @return \Drupal\Core\Theme\Icon\IconDefinitionInterface|null
* The icon loaded.
*/
private function getIconFromExtractor(string $icon_full_id, array $definitions) : ?IconDefinitionInterface {
$icon_data = IconDefinition::getIconDataFromId($icon_full_id);
if (!isset($icon_data['pack_id'])) {
return NULL;
}
$definition = $definitions[$icon_data['pack_id']] ?? NULL;
if (NULL === $definition) {
return NULL;
}
$icon_definition = $definition['icons'][$icon_full_id] ?? NULL;
if (NULL === $icon_definition) {
return NULL;
}
$icon_definition['icon_id'] = $icon_data['icon_id'];
// Clean to data to reduce the array passed to createInstance().
unset($definition['icons']);
/** @var \Drupal\Core\Theme\Icon\IconExtractorInterface $extractor */
$extractor = $this->iconPackExtractorManager
->createInstance($definition['extractor'], $definition);
return $extractor->loadIcon($icon_definition);
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title | Overrides |
---|---|---|---|---|---|
CacheCollector::$cache | protected | property | The cache backend that should be used. | 1 | |
CacheCollector::$cacheCreated | protected | property | Stores the cache creation time. | ||
CacheCollector::$cacheInvalidated | protected | property | Flag that indicates of the cache has been invalidated. | ||
CacheCollector::$cacheLoaded | protected | property | Indicates if the collected cache was already loaded. | ||
CacheCollector::$cid | protected | property | The cache id that is used for the cache entry. | ||
CacheCollector::$keysToPersist | protected | property | An array of keys to add to the cache on service termination. | ||
CacheCollector::$keysToRemove | protected | property | An array of keys to remove from the cache on service termination. | ||
CacheCollector::$lock | protected | property | The lock backend that should be used. | 1 | |
CacheCollector::$storage | protected | property | Storage for the data itself. | ||
CacheCollector::$tags | protected | property | A list of tags that are used for the cache entry. | ||
CacheCollector::clear | public | function | Clears the collected cache entry. | Overrides CacheCollectorInterface::clear | 1 |
CacheCollector::delete | public | function | Deletes the element. | Overrides CacheCollectorInterface::delete | 1 |
CacheCollector::destruct | public | function | Performs destruct operations. | Overrides DestructableInterface::destruct | |
CacheCollector::getCid | protected | function | Gets the cache ID. | 3 | |
CacheCollector::has | public | function | Returns whether data exists for this key. | Overrides CacheCollectorInterface::has | 1 |
CacheCollector::invalidateCache | protected | function | Invalidate the cache. | ||
CacheCollector::lazyLoadCache | protected | function | Loads the cache if not already done. | 1 | |
CacheCollector::persist | protected | function | Flags an offset value to be written to the persistent cache. | ||
CacheCollector::reset | public | function | Resets the local cache. | Overrides CacheCollectorInterface::reset | 1 |
CacheCollector::updateCache | protected | function | Writes a value to the persistent cache immediately. | 1 | |
IconCollector::get | public | function | Gets value from the cache. | Overrides CacheCollector::get | |
IconCollector::getIconFromExtractor | private | function | Returns the icon from an icon id and icon pack definition. | ||
IconCollector::resolveCacheMiss | public | function | Resolves a cache miss. | Overrides CacheCollector::resolveCacheMiss | |
IconCollector::set | public | function | Implements \Drupal\Core\Cache\CacheCollectorInterface::set(). | Overrides CacheCollector::set | |
IconCollector::__construct | public | function | Constructs a IconCollector instance. | Overrides CacheCollector::__construct |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.