KGzocha\Searcher\AbstractCollection

Complexity

Total Complexity

14

Size/Duplication

Total Lines	123
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	0

Test Coverage

Coverage

100%

Importance

Changes	2
Bugs	1	Features	1

10 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	8	1
	isItemValid()	0	1	?
A	getIterator()	0	4	1
A	count()	0	4	1
A	addItem()	0	6	1
A	addNamedItem()	0	6	1
A	getItems()	0	4	1
A	getNamedItem()	0	8	2
A	isTraversable()	0	9	3
A	checkItems()	0	13	3

<?php

namespace KGzocha\Searcher;

/**
 * @author Krzysztof Gzocha <krzysztof@propertyfinder.ae>
 */
abstract class AbstractCollection implements \Countable, \IteratorAggregate
{
    /**
     * @var array
     */
    private $items;

    /**
     * @param \Traversable|array $items
     */
    public function __construct($items = [])
    {
        $this->items = [];
        $this->isTraversable($items);
        $this->checkItems($items);

        $this->items = $items;
    }

    /**
     * @param object $item
     *
     * @return bool
     */
    abstract protected function isItemValid($item);

    /**
     * {@inheritdoc}
     */
    public function getIterator()
    {
        return new \ArrayIterator($this->items);
    }

    /**
     * {@inheritdoc}
     */
    public function count()
    {
        return count($this->items);
    }

    /**
     * @param mixed $item
     *
     * @return $this
     */
    protected function addItem($item)
    {
        $this->items[] = $item;

        return $this;
    }

    /**
     * @param string $name
     * @param mixed  $item
     *
     * @return $this
     */
    protected function addNamedItem($name, $item)
    {
        $this->items[$name] = $item;

        return $this;
    }

    /**
     * @return array
     */
    protected function getItems()
    {
        return $this->items;
    }

    /**
     * @param string $name
     *
     * @return mixed|null
     */
    protected function getNamedItem($name)
    {
        if (array_key_exists($name, $this->items)) {
            return $this->items[$name];
        }

        return null;
    }

    /**
     * @param mixed $items
     *
     * @throws \InvalidArgumentException
     */
    private function isTraversable($items)
    {
        if (!is_array($items) && !$items instanceof \Traversable) {
            throw new \InvalidArgumentException(sprintf(
                'Argument passed to collection %s needs to be an array or traversable object',
                get_class($this)
            ));
        }
    }

    /**
     * @param array|\Traversable $items
     *
     * @throws \InvalidArgumentException
     */
    private function checkItems($items)
    {
        foreach ($items as $item) {
            if ($this->isItemValid($item)) {
                continue;
            }

            throw new \InvalidArgumentException(sprintf(
                'At least one item in collection "%s" is invalid.',
                get_class($this)
            ));
        }
    }
}