Spinen\ConnectWise\Support\Model

Complexity

Total Complexity

45

Size/Duplication

Total Lines	401
Duplicated Lines	0 %

Test Coverage

Coverage

76.4%

Importance

Changes

0

24 Methods

Rating	Name	Duplication	Size	Complexity
A	setAttribute()	0	13	3
A	offsetGet()	0	3	1
A	__construct()	0	4	1
A	__unset()	0	3	1
B	castTo()	0	49	8
A	getterMethodName()	0	3	1
A	__toString()	0	3	1
A	hasCast()	0	5	2
A	__isset()	0	3	1
B	__call()	0	20	7
A	hasGetter()	0	3	1
A	__set()	0	3	1
A	getCasts()	0	7	2
A	setterMethodName()	0	3	1
A	getAttribute()	0	15	4
A	offsetUnset()	0	3	1
A	fill()	0	7	2
A	offsetSet()	0	3	1
A	offsetExists()	0	3	1
A	hasSetter()	0	3	1
A	__get()	0	3	1
A	toJson()	0	3	1
A	toArray()	0	4	1
A	jsonSerialize()	0	3	1

<?php

namespace Spinen\ConnectWise\Support;

use ArrayAccess;
use Carbon\Carbon;
use Illuminate\Contracts\Support\Arrayable;
use Illuminate\Contracts\Support\Jsonable;
use Illuminate\Support\Str;
use InvalidArgumentException;
use JsonSerializable;
use Spinen\ConnectWise\Api\Client;

/**
 * Class Model
 *
 * This class is heavily modeled after Laravel's Eloquent model.  We are wanting the API to be familiar as we use
 * Laravel for most of our projects & want it to be very easily to have our developers use it.  Additionally, it is
 * just so well done, that there there is not a reason to not copy/reuse some of the code.
 *
 * @package Spinen\ConnectWise\Support
 */
abstract class Model implements ArrayAccess, Arrayable, Jsonable, JsonSerializable
{
    /**
     * The collection of attributes for the model
     *
     * @var array
     */
    protected $attributes = [];

    /**
     * Properties that need to be casts to a specific object or type
     *
     * @var array
     */
    protected $casts = [];

    /**
     * Client instance to go get related properties
     *
     * @var Client|null
     */
    protected $client;

    /**
     * Model constructor.
     *
     * @param array $attributes
     * @param Client|null $client
     */
    public function __construct(array $attributes, Client $client = null)
    {
        $this->client = $client;
        $this->fill($attributes);
    }

    /**
     * Convert the model to its string representation.
     *
     * @return string
     */
    public function __toString()
    {
        return $this->toJson();
    }

    /**
     * Magic method to allow getting related items
     *
     * @param string $method
     * @param mixed $arguments
     *
     * @return mixed
     */
    public function __call($method, $arguments)
    {
        // Call existing method
        if (method_exists($this, $method)) {
            return call_user_func_array([$this, $method], $arguments);
        }

        // Look to see if the property has a relationship to call
        if ($this->client && is_array($this->{$method}) && array_key_exists('_info', $this->{$method})) {
            foreach ($this->{$method}['_info'] as $k => $v) {
                if (Str::startsWith($v, $this->client->getUrl())) {
                    // Cache so that other request will not trigger additional calls
                    $this->{$method} = $this->client->get(Str::replaceFirst($this->client->getUrl(), '', $v));

                    return $this->{$method};
                }
            }
        }

        trigger_error('Call to undefined method ' . __CLASS__ . '::' . $method . '()', E_USER_ERROR);
    }

    /**
     * Allow the attributes of the model to be accessed like a public property
     *
     * @param string $attribute
     *
     * @return mixed
     */
    public function __get($attribute)
    {
        return $this->getAttribute($attribute);
    }

    /**
     * Allow checking to see if the model has an attribute set
     *
     * @param string $attribute
     *
     * @return bool
     */
    public function __isset($attribute)
    {
        return array_key_exists($attribute, $this->attributes);
    }

    /**
     * Set a property on the model in the attributes
     *
     * @param string $attribute
     * @param mixed  $value
     */
    public function __set($attribute, $value)
    {
        $this->setAttribute($attribute, $value);
    }

    /**
     * Unset a property on the model in the attributes
     *
     * @param string $attribute
     */
    public function __unset($attribute)
    {
        unset($this->attributes[$attribute]);
    }

    /**
     * Cast a item to a specific object or type
     *
     * @param mixed  $value
     * @param string $cast
     *
     * @return mixed
     */
    public function castTo($value, $cast)
    {
        if (is_null($value)) {
            return $value;
        }

        $class = 'Spinen\ConnectWise\\' . $cast;

        if (class_exists($class)) {
            return new $class($value);
        }

        if (strcasecmp('carbon', $cast) == 0) {
            return Carbon::parse($value);
        }

        if (strcasecmp('json', $cast) == 0) {
            return json_encode((array)$value);
        }

        if (strcasecmp('collection', $cast) == 0) {
            return new Collection((array)$value);
        }

        if (in_array($cast, ['bool', 'boolean'])) {
            return filter_var($value, FILTER_VALIDATE_BOOLEAN);
        }

        $cast_types = [
            'array',
            'bool',
            'boolean',
            'double',
            'float',
            'int',
            'integer',
            'null',
            'object',
            'string',
        ];

        if (!in_array($cast, $cast_types)) {
            throw new InvalidArgumentException(sprintf("Attributes cannot be casted to [%s] type.", $cast));
        }

        settype($value, $cast);

        // settype returns true/false for pass/fail, not the value
        return $value;
    }

    /**
     * Store the collection of attributes on the model
     *
     * @param array $attributes
     *
     * @return $this
     */
    public function fill(array $attributes)
    {
        foreach ($attributes as $attribute => $value) {
            $this->setAttribute($attribute, $value);
        }

        return $this;
    }

    /**
     * Check to see if there is a getter for the attribute
     *
     * @param string $attribute
     *
     * @return bool
     */
    public function hasGetter($attribute)
    {
        return method_exists($this, $this->getterMethodName($attribute));
    }

    /**
     * Check to see if there is a setter for the attribute
     *
     * @param string $attribute
     *
     * @return bool
     */
    public function hasSetter($attribute)
    {
        return method_exists($this, $this->setterMethodName($attribute));
    }

    /**
     * Is the attribute supposed to be cast
     *
     * @param string $attribute
     *
     * @return bool
     */
    public function hasCast($attribute)
    {
        $cast = $this->getCasts($attribute);

        return !empty($cast) && is_string($cast);
    }

    /**
     * Get the attribute from the model
     *
     * @param string $attribute
     *
     * @return mixed
     */
    public function getAttribute($attribute)
    {
        if (!$attribute) {
            return;
        }

        if ($this->hasGetter($attribute)) {
            return $this->{$this->getterMethodName($attribute)}();
        }

        if (isset($this->$attribute)) {
            return $this->attributes[$attribute];
        };

        trigger_error('Undefined property:'. __CLASS__ . '::$' . $attribute);
    }

    /**
     * Get the array of cast or a specific cast for an attribute
     *
     * @param null $attribute

Are you sure the doc-type for parameter $attribute is correct as it would always require null to be passed?

     *
     * @return mixed
     */
    public function getCasts($attribute = null)
    {
        if (array_key_exists($attribute, $this->casts)) {
            return $this->casts[$attribute];
        }

        return $this->casts;
    }

    /**
     * Build the name of the getter for an attribute
     *
     * @param string $attribute
     *
     * @return string
     */
    protected function getterMethodName($attribute)
    {
        return 'get' . Str::studly($attribute) . 'Attribute';
    }

    /**
     * Serialize Json (convert it to an array)
     *
     * @return array
     */
    public function jsonSerialize()
    {
        return $this->toArray();
    }

    /**
     * Allow the model to behave like an associate array, so see if attribute is set
     *
     * @param string $attribute
     *
     * @return boolean
     */
    public function offsetExists($attribute)
    {
        return isset($this->$attribute);
    }

    /**
     * Allow the model to behave like an associate array, so get attribute
     *
     * @param string $attribute
     *
     * @return mixed
     */
    public function offsetGet($attribute)
    {
        return $this->$attribute;
    }

    /**
     * Allow the model to behave like an associate array, so set attribute
     *
     * @param string $attribute
     * @param mixed  $value
     */
    public function offsetSet($attribute, $value)
    {
        $this->$attribute = $value;
    }

    /**
     * Allow the model to behave like an associate array, so unset attribute
     *
     * @param mixed $attribute
     *
     * @return void
     */
    public function offsetUnset($attribute)
    {
        unset($this->$attribute);
    }

    /**
     * Set value on an attribute
     *
     * Since there can be a setter for an attribute, look to see if there is one to delegate the setting.  Then see if
     * the attribute is supposed to be cast to a specific value before setting.  Finally, store the value on the model.
     *
     * @param string $attribute
     * @param mixed  $value
     *
     * @return $this
     */
    public function setAttribute($attribute, $value)
    {
        if ($this->hasSetter($attribute)) {
            return $this->{$this->setterMethodName($attribute)}($value);
        }

        if ($this->hasCast($attribute)) {
            $value = $this->castTo($value, $this->getCasts($attribute));

It seems like $this->getCasts($attribute) can also be of type array; however, parameter $cast of Spinen\ConnectWise\Support\Model::castTo() does only seem to accept string, maybe add an additional type check?

        }

        $this->attributes[$attribute] = $value;

        return $this;
    }

    /**
     * Build the name of the setter for an attribute
     *
     * @param string $attribute
     *
     * @return string
     */
    protected function setterMethodName($attribute)
    {
        return 'set' . Str::studly($attribute) . 'Attribute';
    }

    /**
     * Return the model as an array
     *
     * @return array
     */
    public function toArray()
    {
        // TODO: Need to actually roll through the attributes & make sure that nested objects are converted
        return $this->attributes;
    }

    /**
     * Return the model as JSON
     *
     * @param int $options
     *
     * @return string
     */
    public function toJson($options = 0)
    {
        return json_encode($this->jsonSerialize(), $options);
    }
}