EventEspresso\core\services\loaders\CachingLoader

Complexity

Total Complexity

10

Size/Duplication

Total Lines	116
Duplicated Lines	0 %

Coupling/Cohesion

Components	2
Dependencies	4

Importance

Changes

0

5 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	21	2
A	identifier()	0	4	1
A	setIdentifier()	0	7	2
B	load()	0	24	4
A	reset()	0	5	1

<?php

namespace EventEspresso\core\services\loaders;

use EventEspresso\core\exceptions\InvalidDataTypeException;
use EventEspresso\core\exceptions\InvalidEntityException;
use EventEspresso\core\services\collections\CollectionInterface;
use EventEspresso\core\services\container\exceptions\ServiceNotFoundException;

defined('EVENT_ESPRESSO_VERSION') || exit;



/**
 * Class CachingLoader
 * caches objects returned by the decorated loader
 *
 * @package       Event Espresso
 * @author        Brent Christensen
 * @since         $VID:$
 */
class CachingLoader extends LoaderDecorator
{

    /**
     * @var CollectionInterface $cache
     */
    protected $cache;

    /**
     * @var string $identifier
     */
    protected $identifier;



    /**
     * CachingLoader constructor.
     *
     * @param LoaderDecoratorInterface $loader
     * @param CollectionInterface      $cache
     * @param string                   $identifier
     * @throws InvalidDataTypeException
     */
    public function __construct(LoaderDecoratorInterface $loader, CollectionInterface $cache, $identifier = '')
    {
        parent::__construct($loader);
        $this->cache = $cache;
        $this->setIdentifier($identifier);
        if ($this->identifier !== '') {
            // to only clear this cache, and assuming an identifier has been set, simply do the following:
            // do_action('AHEE__EventEspresso\core\services\loaders\CachingLoader__resetCache__IDENTIFIER');
            // where "IDENTIFIER" = the string that was set during construction
            add_action(
                "AHEE__EventEspresso_core_services_loaders_CachingLoader__resetCache__{$identifier}",
                array($this, 'reset')
            );
        }
        // to clear ALL caches, simply do the following:
        // do_action('AHEE__EventEspresso_core_services_loaders_CachingLoader__resetCache');
        add_action(
            'AHEE__EventEspresso_core_services_loaders_CachingLoader__resetCache',
            array($this, 'reset')
        );
    }



    /**
     * @return string
     */
    public function identifier()
    {
        return $this->identifier;
    }



    /**
     * @param string $identifier
     * @throws InvalidDataTypeException
     */
    private function setIdentifier($identifier)
    {
        if ( ! is_string($identifier)) {
            throw new InvalidDataTypeException('$identifier', $identifier, 'string');
        }
        $this->identifier = $identifier;
    }



    /**
     * @param string $fqcn
     * @param array  $arguments
     * @return mixed
     * @throws InvalidEntityException
     * @throws ServiceNotFoundException
     */
    public function load($fqcn, $arguments = array())
    {
        $fqcn = ltrim($fqcn, '\\');
        // caching can be turned off via the following code:
        // add_filter('FHEE__EventEspresso_core_services_loaders_CachingLoader__load__bypass_cache', '__return_true');
        if(
            apply_filters(
                'FHEE__EventEspresso_core_services_loaders_CachingLoader__load__bypass_cache',
                false,
                $this
            )
        ){
            return $this->loader->load($fqcn, $arguments);
        }
        $identifier = md5($fqcn . serialize($arguments));
        if($this->cache->has($identifier)){
            return $this->cache->get($identifier);
        }
        $object = $this->loader->load($fqcn, $arguments);
        if($object instanceof $fqcn) {
            $this->cache->add($object, $identifier);
        }
        return $object;
    }



    /**
     * empties cache and calls reset() on loader if method exists
     */
    public function reset()
    {
        $this->cache->detachAll();
        $this->loader->reset();
    }


}
// End of file CachingLoader.php
// Location: EventEspresso\core\services\loaders/CachingLoader.php