Scriptotek\Alma\Model\LazyResource

Complexity

Total Complexity

14

Size/Duplication

Total Lines	131
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Importance

Changes

0

10 Methods

Rating	Name	Duplication	Size	Complexity
A	setParams()	0	5	1
A	getParams()	0	4	1
	isInitialized()	0	1	?
B	init()	0	21	6
A	fetchData()	0	4	1
A	onData()	0	3	1
A	getData()	0	4	1
A	exists()	0	9	2
	urlBase()	0	1	?
A	url()	0	6	1

<?php

namespace Scriptotek\Alma\Model;

use Psr\Http\Message\UriInterface;
use Scriptotek\Alma\Client;
use Scriptotek\Alma\Exception\ResourceNotFound;

/**
 * A LazyResource is anything that has its own URL and therefore can be lazy-loaded.
 * This class implements the basic ghost model functionality.
 *
 * The $initialized property indicates if the model is loaded or not.
 */
abstract class LazyResource extends Model
{
    /**
     * This class is a ghost object that lazy loads the full record only when needed.
     * If $initialized is false, it means we haven't yet loaded the full record.
     * We can still have incomplete data from a search response.
     */
    protected $initialized = false;

    /**
     * @var array Query string parameters
     */
    protected $params = [];

    /**
     * Set request query string parameters.
     * @param $params array
     * @return $this
     */
    public function setParams($params)
    {
        $this->params = $params;
        return $this;
    }

    /**
     * Get the request query string parameters.
     * @return array
     */
    public function getParams()
    {
        return $this->params;
    }

    /**
     * Check if we have the full representation of our data object.
     *
     * @param \stdClass $data
     * @return boolean
     */
    abstract protected function isInitialized($data);

    /**
     * Load data onto this object. Chainable method.
     *
     * @param \stdClass $data
     *
     * @return $this
     */
    public function init($data = null)
    {
        if ($this->initialized) {
            return $this;
        }

        if (is_null($data)) {
            $data = $this->fetchData();
        }

        if (!is_null($data) && $this->isInitialized($data)) {
            $this->initialized = true;
        }

        $this->data = $data;
        if ($this->initialized) {
            $this->onData($data);
        }

        return $this;
    }

    /**
     * Get the model data.
     */
    protected function fetchData()
    {
        return $this->client->getJSON($this->url());
    }

    /**
     * Called when data is available to be processed.
     * The resource classes can use this method to process the data.
     *
     * @param mixed $data
     */
    protected function onData($data)
    {
    }

    /**
     * Get the raw data object.
     */
    public function getData()
    {
        return $this->init()->data;
    }

    /**
     * Check if the object exists.
     */
    public function exists()
    {
        try {
            $this->init();
        } catch (ResourceNotFound $ex) {

Consider adding a comment why this CATCH block is empty.

        }

        return $this->initialized;
    }

    /**
     * Generate the base URL for this resource.
     *
     * @return string
     */
    abstract protected function urlBase();

    /**
     * Build a full URL for a resource.
     *
     * @param string $url
     * @param array $query
     * @return UriInterface
     */
    protected function url($url = '', $query = [])
    {
        $query = array_merge($this->params, $query);

        return $this->client->buildUrl($this->urlBase() . $url, $query);
    }
}