BaseActiveRecordTrait::getRelation() - Code Metrics - Inspection of "Merge pull request #83 from terabytesoft/rework-co..." - yiisoft/active-record - Measure and Improve Code Quality continuously with Scrutinizer

Completed
Push — master ( 928248...a75adc )

by Wilmer
created 2020-03-27 22:22 UTC
BaseActiveRecordTrait::getRelation() B

↳ Parent: BaseActiveRecordTrait
Complexity

Conditions	8
Paths	8
Size

Total Lines	45
Code Lines	23
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	7
CRAP Score	26.9658
Importance

Changes
Metric	Value
eloc	23
dl	0
loc	45
ccs	7
cts	21
cp	0.3333
rs	8.4444
c	0
b	0
f	0
cc	8
nc	8
nop	2
crap	26.9658
<?php

declare(strict_types=1);

namespace Yiisoft\ActiveRecord;

use Yiisoft\Db\Connection\Connection;
use Yiisoft\Db\Connection\ConnectionPool;
use Yiisoft\Db\Exception\InvalidArgumentException;
use Yiisoft\Db\Exception\InvalidCallException;
use Yiisoft\Db\Exception\UnknownMethodException;
use Yiisoft\Db\Exception\UnknownPropertyException;

trait BaseActiveRecordTrait
{
    private static ?string $connectionId = null;

    /**
     * PHP getter magic method.
     *
     * This method is overridden so that attributes and related objects can be accessed like properties.
     *
     * @param string $name property name
     *
     * @throws InvalidCallException
     * @throws UnknownPropertyException
     *
     * @return mixed property value
     *
     * {@see getAttribute()}
     */
    public function __get(string $name)
    {
        if (isset($this->attributes[$name]) || \array_key_exists($name, $this->attributes)) {
            return $this->attributes[$name];
        }

        if ($this->hasAttribute($name)) {
        if ($this->/** @scrutinizer ignore-call */ hasAttribute($name)) {
            return null;
        }

        if (isset($this->related[$name]) || \array_key_exists($name, $this->related)) {
            return $this->related[$name];
        }

        $value = $this->checkRelation($name);

        if ($value instanceof ActiveQueryInterface) {
            $this->setRelationDependencies($name, $value);
                   setRelationDependencies($name, $value);
            return $this->related[$name] = $value->findFor($name, $this);
            return $this->related[$name] = $value->findFor($name, /** @scrutinizer ignore-type */ $this);
        }

        return $value;
    }

    public function checkRelation(string $name)
    {
        $getter = 'get' . $name;

        if (\method_exists($this, $getter)) {
            // read property, e.g. getName()
            return $this->$getter();
        }

        if (\method_exists($this, 'set' . $name)) {
            throw new InvalidCallException('Getting write-only property: ' . \get_class($this) . '::' . $name);
        }

        throw new UnknownPropertyException('Getting unknown property: ' . \get_class($this) . '::' . $name);
    }


    /**
     * Returns the relation object with the specified name.
     *
     * A relation is defined by a getter method which returns an {@see ActiveQueryInterface} object.
     *
     * It can be declared in either the Active Record class itself or one of its behaviors.
     *
     * @param string $name the relation name, e.g. `orders` for a relation defined via `getOrders()` method
     * (case-sensitive).
     * @param bool $throwException whether to throw exception if the relation does not exist.
     *
     * @throws InvalidArgumentException if the named relation does not exist.
     * @throws \ReflectionException
     *
     * @return ActiveQueryInterface|ActiveQuery the relational query object. If the relation does not exist and
     * `$throwException` is `false`, `null` will be returned.
     */
    public function getRelation(string $name, bool $throwException = true)
    {
        $getter = 'get' . $name;

        try {
            // the relation could be defined in a behavior
            $relation = $this->$getter();
        } catch (UnknownMethodException $e) {
            if ($throwException) {
                throw new InvalidArgumentException(
                    \get_class($this) . ' has no relation named "' . $name . '".',
                    0,
                    /** @scrutinizer ignore-type */ 0,
                    $e
                    /** @scrutinizer ignore-type */ $e
                );
            }

            return null;
        }

        if (!$relation instanceof ActiveQueryInterface) {
            if ($throwException) {
                throw new InvalidArgumentException(\get_class($this) . ' has no relation named "' . $name . '".');
            }

            return null;
        }

        if (\method_exists($this, $getter)) {
            /* relation name is case sensitive, trying to validate it when the relation is defined within this class */
            $method = new \ReflectionMethod($this, $getter);
            $realName = \lcfirst(\substr($method->getName(), 3));

            if ($realName !== $name) {
                if ($throwException) {
                    throw new InvalidArgumentException(
                        'Relation names are case sensitive. ' . \get_class($this)
                        . " has a relation named \"$realName\" instead of \"$name\"."
                    );
                }

                return null;
            }
        }

        return $relation;
    }

    /**
     * Checks if a property value is null.
     *
     * This method overrides the parent implementation by checking if the named attribute is `null` or not.
     *
     * @param string $name the property name or the event name
     *
     * @return bool whether the property value is null
     */
    public function __isset(string $name): bool
    {
        try {
            return $this->__get($name) !== null;
        } catch (\Throwable $t) {
            return false;
        } catch (\Exception $e) {
            return false;
        }
    }

    /**
     * Sets a component property to be null.
     *
     * This method overrides the parent implementation by clearing the specified attribute value.
     *
     * @param string $name the property name or the event name.
     *
     * @throws InvalidArgumentException
     * @throws \ReflectionException
     */
    public function __unset($name): void
    {
        if ($this->hasAttribute($name)) {
            unset($this->attributes[$name]);
            if (!empty($this->relationsDependencies[$name])) {

                $this->resetDependentRelations($name);
                       resetDependentRelations($name);
            }
        } elseif (\array_key_exists($name, $this->related)) {
            unset($this->related[$name]);
        } elseif ($this->getRelation($name, false) === null) {
            parent::__unset($name);
        }
    }

    /**
     * PHP setter magic method.
     *
     * This method is overridden so that AR attributes can be accessed like properties.
     *
     * @param string $name property name
     * @param mixed $value property value
     *
     * @throws InvalidCallException
     */
    public function __set($name, $value): void
    {
        if ($this->hasAttribute($name)) {
            if (
                !empty($this->relationsDependencies[$name])

                && (!\array_key_exists($name, $this->attributes) || $this->attributes[$name] !== $value)
            ) {
                $this->resetDependentRelations($name);
            }
            $this->attributes[$name] = $value;

        }

        if (method_exists($this, 'get' . $name)) {
            throw new InvalidCallException('Setting read-only property: ' . get_class($this) . '::' . $name);
        }
    }

    /**
     * Returns an iterator for traversing the attributes in the ActiveRecord.
     *
     * This method is required by the interface {@see \IteratorAggregate}.
     *
     * @return \ArrayIterator an iterator for traversing the items in the list.
     */
    public function getIterator(): \ArrayIterator
    {
        $attributes = $this->getAttributes();
        $attributes = $this->getAttributes();

        return new \ArrayIterator($attributes);
    }

    /**
     * Returns whether there is an element at the specified offset.
     *
     * This method is required by the SPL interface {@see \ArrayAccess}.
     *
     * It is implicitly called when you use something like `isset($model[$offset])`.
     *
     * @param mixed $offset the offset to check on.
     *
     * @return bool whether or not an offset exists.
     */
    public function offsetExists($offset): bool
    {
        return isset($this->$offset);
    }

    /**
     * Returns the element at the specified offset.
     *
     * This method is required by the SPL interface {@see \ArrayAccess}.
     *
     * It is implicitly called when you use something like `$value = $model[$offset];`.
     *
     * @param mixed $offset the offset to retrieve element.
     *
     * @return mixed the element at the offset, null if no element is found at the offset
     */
    public function offsetGet($offset)
    {
        return $this->$offset;
    }

    /**
     * Sets the element at the specified offset.
     *
     * This method is required by the SPL interface {@see \ArrayAccess}.
     *
     * It is implicitly called when you use something like `$model[$offset] = $item;`.
     *
     * @param mixed $offset the offset to set element
     * @param mixed $item the element value
     */
    public function offsetSet($offset, $item): void
    {
        $this->$offset = $item;
    }

    /**
     * Sets the element value at the specified offset to null.
     *
     * This method is required by the SPL interface {@see \ArrayAccess}.
     *
     * It is implicitly called when you use something like `unset($model[$offset])`.
     *
     * @param mixed $offset the offset to unset element
     */
    public function offsetUnset($offset): void
    {
        if (\property_exists($this, $offset)) {
            $this->$offset = null;
        } else {
            unset($this->$offset);
        }
    }

    /**
     * Returns a value indicating whether a property is defined for this component.
     *
     * A property is defined if:
     *
     * - the class has a getter or setter method associated with the specified name (in this case, property name is
     *   case-insensitive).
     * - the class has a member variable with the specified name (when `$checkVars` is true).
     * - an attached behavior has a property of the given name (when `$checkBehaviors` is true).
     *
     * @param string $name the property name
     * @param bool $checkVars whether to treat member variables as properties
     * @param bool $checkBehaviors whether to treat behaviors' properties as properties of this component
     *
     * @return bool whether the property is defined
     *
     * {@see canGetProperty()}
     * {@see canSetProperty()}
     */
    public function hasProperty($name, $checkVars = true, $checkBehaviors = true): bool
    {
        return $this->canGetProperty($name, $checkVars, $checkBehaviors)
        return $this->/** @scrutinizer ignore-call */ canGetProperty($name, $checkVars, $checkBehaviors)
            || $this->canSetProperty($name, false, $checkBehaviors);
            || $this->/** @scrutinizer ignore-call */ canSetProperty($name, false, $checkBehaviors);
    }


    public static function getConnection(): Connection
    {
        return ConnectionPool::getConnectionPool(self::$connectionId);
        return ConnectionPool::getConnectionPool(/** @scrutinizer ignore-type */ self::$connectionId);
    }

    /**
     * @param string|null $value index value list connections in ConnectionPool.
     */
    public static function connectionId(string $value): void
    {
        self::$connectionId = $value;
    }

    public function canGetProperty(string $name, bool $checkVars = true): bool
    {
        if (\method_exists($this, 'get' . $name) || ($checkVars && \property_exists($this, $name))) {
            return true;
        }

        try {
            return $this->hasAttribute($name);
        } catch (\Exception $e) {
            /* `hasAttribute()` may fail on base/abstract classes in case automatic attribute list fetching used */
            return false;
        }
    }

    public function canSetProperty(string $name, bool $checkVars = true): bool
    {
        if (\method_exists($this, 'set' . $name) || ($checkVars && \property_exists($this, $name))) {
            return true;
        }

        try {
            return $this->hasAttribute($name);
        } catch (\Exception $e) {
            /* `hasAttribute()` may fail on base/abstract classes in case automatic attribute list fetching used */
            return false;
        }
    }
}

yiisoft / active-record

Push — master ( 928248...a75adc )

BaseActiveRecordTrait::getRelation() B

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
