flipbox\spark\services\ElementAccessorByString

Complexity

Total Complexity

20

Size/Duplication

Total Lines	244
Duplicated Lines	5.33 %

Coupling/Cohesion

Components	1
Dependencies	4

Importance

Changes

0

12 Methods

Rating	Name	Duplication	Size	Complexity
	freshFindByString()	0	1	?
A	freshGetByString()	0	12	2
A	find()	0	12	2
B	findByString()	0	24	3
A	getByString()	0	13	2
A	findCacheByString()	0	13	2
A	cacheByString()	0	21	3
A	findCache()	0	12	2
A	addToCache()	0	9	1
A	notFoundByStringException()	0	11	1
	stringValue()	0	1	?
A	isCachedByString()	13	13	2

<?php

/**
 * @package    Spark
 * @author     Flipbox Factory <hello@flipboxfactory.com>
 * @copyright  2010-2016 Flipbox Digital Limited
 * @license    https://github.com/FlipboxFactory/Craft3-Spark/blob/master/LICENSE
 * @link       https://github.com/FlipboxFactory/Craft3-Spark
 * @since      Class available since Release 1.2.0
 */

namespace flipbox\spark\services;

use craft\base\Element;
use craft\base\ElementInterface;
use flipbox\spark\exceptions\ElementNotFoundException;
use flipbox\spark\helpers\SiteHelper;

abstract class ElementAccessorByString extends ElementAccessor
{

    /**
     * @var [ElementInterface[]]
     */
    protected $_cacheByString = [];

    /*******************************************
     * ABSTRACTS
     *******************************************/

    /**
     * @param $string
     * @param int|null $siteId
     * @return Element|ElementInterface|null
     */
    abstract protected function freshFindByString(string $string, int $siteId = null);

    /**
     * @param ElementInterface $element
     * @return string
     */
    abstract protected function stringValue(ElementInterface $element);


    /**
     * @param $string
     * @param int|null $siteId
     * @return Element|ElementInterface
     * @throws ElementNotFoundException
     */
    public function freshGetByString($string, int $siteId = null)
    {

        if (!$element = $this->freshFindByString($string, $siteId)) {

            $this->notFoundByStringException($string);

        }

        return $element;

    }


    /*******************************************
     * FIND
     *******************************************/

    /**
     * @inheritdoc
     */
    public function find($identifier, int $siteId = null)
    {

        if (is_string($identifier)) {

            return $this->findByString($identifier, $siteId);

        }

        return parent::find($identifier, $siteId);

    }

    /**
     * @param $string
     * @param int|null $siteId
     * @return Element|ElementInterface|null
     */
    public function findByString($string, int $siteId = null)
    {

        // Check cache
        if (!$element = $this->findCacheByString($string)) {

            // Find new element
            if ($element = $this->freshFindByString($string, $siteId)) {

                // Cache it
                $this->cacheByString($element);

            } else {

                // Cache nothing
                $this->_cacheByString[$string] = $element;

            }

        }

        return $element;

    }


    /*******************************************
     * GET
     *******************************************/

    /**
     * @param $string
     * @param int|null $siteId
     * @return Element|ElementInterface
     * @throws ElementNotFoundException
     */
    public function getByString($string, int $siteId = null)
    {

        // Find by Handle
        if (!$element = $this->findByString($string, $siteId)) {

            $this->notFoundByStringException($string);

        }

        return $element;

    }


    /*******************************************
     * CACHE
     *******************************************/

    /**
     * Find an existing cache by Handle
     *
     * @param $string
     * @param int|null $siteId
     * @return Element|ElementInterface|null
     */
    public function findCacheByString($string, int $siteId = null)
    {

        // Check if already in cache
        if ($this->isCachedByString($string, $siteId)) {

            return $this->_cacheByString[$siteId][$string];

        }

        return null;

    }

    /**
     * Identify whether in cached by string
     *
     * @param $string
     * @param int|null $siteId
     * @return bool
     */
    protected function isCachedByString($string, int $siteId = null)

This method seems to be duplicated in your project.

    {

        // Resolve siteId
        $siteId = SiteHelper::resolveSiteId($siteId);

        if (!isset($this->_cacheByString[$siteId])) {
            $this->_cacheByString[$siteId] = [];
        }

        return array_key_exists($string, $this->_cacheByString);

    }

    /**
     * @param ElementInterface $element
     * @return $this
     */
    protected function cacheByString(ElementInterface $element)
    {

        /** @var Element $element */

        $stringValue = $this->stringValue($element);

        // Resolve siteId
        $siteId = SiteHelper::resolveSiteId($element->siteId);

        // Check if already in cache
        if ($stringValue && !$this->isCachedByString($stringValue, $siteId)) {

            // Cache it
            $this->_cacheByString[$siteId][$stringValue] = $element;

        }

        return $this;

    }

    /**
     * @inheritdoc
     */
    public function findCache($identifier, int $siteId = null)
    {

        if (is_string($identifier)) {

            return $this->findCacheByString($identifier, $siteId);

        }

        return parent::findCache($identifier, $siteId);

    }

    /**
     * @inheritdoc
     */
    public function addToCache(ElementInterface $element)
    {

        // Cache by String
        $this->cacheByString($element);

        return parent::addToCache($element);

    }

    /*******************************************
     * EXCEPTIONS
     *******************************************/

    /**
     * @param null $string
     * @throws ElementNotFoundException
     */
    protected function notFoundByStringException($string = null)
    {

        throw new ElementNotFoundException(
            sprintf(
                'Element does not exist with the string "%s".',
                (string)$string
            )
        );

    }

}