AbstractGenericProperties::setProperty() - Code Metrics - Inspection of "Introduced object property serialization" - apparat/object - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 027918...a3ee43 )

by Joschi

created 2016-06-09 21:26 UTC

AbstractGenericProperties::setProperty() A

↳ Parent: AbstractGenericProperties

Complexity

Conditions	1
Paths	1

Size

Total Lines	4
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	2
CRAP Score	1

Importance

Changes	3
Bugs	0	Features	1

Metric	Value
cc	1
eloc	2
c	3
b	0
f	1
nc	1
nop	2
dl	0
loc	4
ccs	2
cts	2
cp	1
crap	1
rs	10

<?php

/**
 * apparat-object
 *
 * @category    Apparat
 * @package     Apparat\Object
 * @subpackage  Apparat\Object\Application
 * @author      Joschi Kuphal <[email protected]> / @jkphl
 * @copyright   Copyright © 2016 Joschi Kuphal <[email protected]> / @jkphl
 * @license     http://opensource.org/licenses/MIT The MIT License (MIT)
 */

/***********************************************************************************
 *  The MIT License (MIT)
 *
 *  Copyright © 2016 Joschi Kuphal <[email protected]> / @jkphl
 *
 *  Permission is hereby granted, free of charge, to any person obtaining a copy of
 *  this software and associated documentation files (the "Software"), to deal in
 *  the Software without restriction, including without limitation the rights to
 *  use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
 *  the Software, and to permit persons to whom the Software is furnished to do so,
 *  subject to the following conditions:
 *
 *  The above copyright notice and this permission notice shall be included in all
 *  copies or substantial portions of the Software.
 *
 *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
 *  FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
 *  COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
 *  IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 *  CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ***********************************************************************************/

namespace Apparat\Object\Domain\Model\Properties;

use Apparat\Object\Application\Utility\ArrayUtility;
use Apparat\Object\Domain\Model\Object\ObjectInterface;

/**
 * Abstract generic object properties collection
 *
 * @package Apparat\Object
 * @subpackage Apparat\Object\Application
 */
abstract class AbstractGenericProperties extends AbstractProperties implements GenericPropertiesInterface
{
    /**
     * Property collection constructor
     *
     * @param array $data Property data
     * @param ObjectInterface $object Owner object
     */
    public function __construct(array $data, ObjectInterface $object)
    {
        parent::__construct($data, $object);
    }

    /**
     * Get a property value
     *
     * Multi-level properties might be traversed by property name paths separated with colons (":").
     *
     * @param string $property Property name
     * @return mixed Property value
     * @throws InvalidArgumentException If the property name is invalid
     */
    public function getProperty($property)
    {
        $propertyPath = $this->buildPropertyPath($property);

        // Traverse the property tree
        $propertyPathSteps = [];
        $data =& $this->data;
        foreach ($propertyPath as $property) {
            $propertyPathSteps[] = $property;

            // If the property name step is invalid
            if (!array_key_exists($property, $data)) {
                throw new InvalidArgumentException(
                    sprintf(
                        'Invalid property name "%s"',
                        implode(self::PROPERTY_TRAVERSAL_SEPARATOR, $propertyPathSteps)
                    ),
                    InvalidArgumentException::INVALID_PROPERTY_NAME
                );
            }

            $data =& $data[$property];
        }

        return $data;
    }

    /**
     * Translate a property name to a property path segments
     *
     * @param string $property Property name
     * @return array Property path
     * @throws InvalidArgumentException If the property name is empty
     */
    protected function buildPropertyPath($property)
    {
        $propertyPath = array_filter(array_map('trim', explode(self::PROPERTY_TRAVERSAL_SEPARATOR, $property)));

        // If the property traversal path is empty
        if (!count($propertyPath)) {
            throw new InvalidArgumentException('Empty property name', InvalidArgumentException::EMPTY_PROPERTY_NAME);
        }

        return $propertyPath;
    }

    /**
     * Set a property value
     *
     * Multi-level properties might be traversed by property name paths separated with colons (":").
     *
     * @param string $property Property name
     * @param mixed $value Property value
     * @return GenericPropertiesInterface Self reference
     */
    public function setProperty($property, $value)
    {
        return $this->setPropertyPath($this->buildPropertyPath($property), $this->data, $value);
    }

    /**
     * Set a property value by path list and base data
     *
     * @param array $propertyPath Path list
     * @param array $propertyTree Base data
     * @param mixed $value Property value
     * @return GenericPropertiesInterface Self reference
     */
    protected function setPropertyPath(array $propertyPath, array $propertyTree, $value)
    {
        // Traverse the property tree and find the property node to set
        $created = false;
        $data =& $this->findPropertyNode($propertyPath, $propertyTree, $created);

        // If a new property is created with a non-empty value or an existing property is altered: Mutate
        if ($created ? !empty($value) : !$this->assertEquals($data, $value)) {
            $data = $value;
            return new static($propertyTree, $this->object);
        }

        return $this;
    }

    /**
     * Traverse the property tree and return a possibly node
     *
     * @param array $propertyPath Property name path
     * @param array $propertyTree Copy of the current property tree
     * @param boolean $created Property has been created
     * @return mixed Property node
     */
    protected function &findPropertyNode(
        array $propertyPath,
        array &$propertyTree,
        &$created
    ) {
        $data =& $propertyTree;

        // Run through all sub-properties
        foreach ($propertyPath as $property) {
            // Create the sub-property if it doesn't exist
            if (!array_key_exists($property, $data)) {
                $data[$property] = [];
                $created = true;
            }

            $data =& $data[$property];
        }

        return $data;
    }

    /**
     * Assert that two values equal
     *
     * @param mixed $expected Expected value
     * @param mixed $actual Actual value
     * @return boolean Actual value equals the expected one
     */
    protected function assertEquals($expected, $actual)
    {
        // If both values don't have the same type
        if (gettype($expected) !== gettype($actual)) {
            return false;
        }

        // If we are comparing arrays
        if (is_array($expected)) {
            return ArrayUtility::reduce($expected) == ArrayUtility::reduce($actual);
        }

        // Compare the values
        return $expected == $actual;
    }
}


1		<?php
2
3		/**
4		* apparat-object
5		*
6		* @category Apparat
7		* @package Apparat\Object
8		* @subpackage Apparat\Object\Application
9		* @author Joschi Kuphal <[email protected]> / @jkphl
10		* @copyright Copyright © 2016 Joschi Kuphal <[email protected]> / @jkphl
11		* @license http://opensource.org/licenses/MIT The MIT License (MIT)
12		*/
13
14		/***********************************************************************************
15		* The MIT License (MIT)
16		*
17		* Copyright © 2016 Joschi Kuphal <[email protected]> / @jkphl
18		*
19		* Permission is hereby granted, free of charge, to any person obtaining a copy of
20		* this software and associated documentation files (the "Software"), to deal in
21		* the Software without restriction, including without limitation the rights to
22		* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
23		* the Software, and to permit persons to whom the Software is furnished to do so,
24		* subject to the following conditions:
25		*
26		* The above copyright notice and this permission notice shall be included in all
27		* copies or substantial portions of the Software.
28		*
29		* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
30		* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
31		* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
32		* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
33		* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
34		* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
35		***********************************************************************************/
36
37		namespace Apparat\Object\Domain\Model\Properties;
38
39		use Apparat\Object\Application\Utility\ArrayUtility;
40		use Apparat\Object\Domain\Model\Object\ObjectInterface;
41
42		/**
43		* Abstract generic object properties collection
44		*
45		* @package Apparat\Object
46		* @subpackage Apparat\Object\Application
47		*/
48		abstract class AbstractGenericProperties extends AbstractProperties implements GenericPropertiesInterface
49		{
50		/**
51		* Property collection constructor
52		*
53		* @param array $data Property data
54		* @param ObjectInterface $object Owner object
55		*/
56	36	public function __construct(array $data, ObjectInterface $object)
57		{
58	36	parent::__construct($data, $object);
59	36	}
60
61		/**
62		* Get a property value
63		*
64		* Multi-level properties might be traversed by property name paths separated with colons (":").
65		*
66		* @param string $property Property name
67		* @return mixed Property value
68		* @throws InvalidArgumentException If the property name is invalid
69		*/
70	5	public function getProperty($property)
71		{
72	5	$propertyPath = $this->buildPropertyPath($property);
73
74		// Traverse the property tree
75	4	$propertyPathSteps = [];
76	4	$data =& $this->data;
77	4	foreach ($propertyPath as $property) {
78	4	$propertyPathSteps[] = $property;
79
80		// If the property name step is invalid
81	4	if (!array_key_exists($property, $data)) {
82	3	throw new InvalidArgumentException(
83	3	sprintf(
84	3	'Invalid property name "%s"',
85	3	implode(self::PROPERTY_TRAVERSAL_SEPARATOR, $propertyPathSteps)
86	3	),
87		InvalidArgumentException::INVALID_PROPERTY_NAME
88	3	);
89		}
90
91	3	$data =& $data[$property];
92	3	}
93
94	3	return $data;
95		}
96
97		/**
98		* Translate a property name to a property path segments
99		*
100		* @param string $property Property name
101		* @return array Property path
102		* @throws InvalidArgumentException If the property name is empty
103		*/
104	7	protected function buildPropertyPath($property)
105		{
106	7	$propertyPath = array_filter(array_map('trim', explode(self::PROPERTY_TRAVERSAL_SEPARATOR, $property)));
107
108		// If the property traversal path is empty
109	7	if (!count($propertyPath)) {
110	1	throw new InvalidArgumentException('Empty property name', InvalidArgumentException::EMPTY_PROPERTY_NAME);
111		}
112
113	6	return $propertyPath;
114		}
115
116		/**
117		* Set a property value
118		*
119		* Multi-level properties might be traversed by property name paths separated with colons (":").
120		*
121		* @param string $property Property name
122		* @param mixed $value Property value
123		* @return GenericPropertiesInterface Self reference
124		*/
125	5	public function setProperty($property, $value)
126		{
127	5	return $this->setPropertyPath($this->buildPropertyPath($property), $this->data, $value);
128		}
129
130		/**
131		* Set a property value by path list and base data
132		*
133		* @param array $propertyPath Path list
134		* @param array $propertyTree Base data
135		* @param mixed $value Property value
136		* @return GenericPropertiesInterface Self reference
137		*/
138	1	protected function setPropertyPath(array $propertyPath, array $propertyTree, $value)
139		{
140		// Traverse the property tree and find the property node to set
141	1	$created = false;
142	1	$data =& $this->findPropertyNode($propertyPath, $propertyTree, $created);
143
144		// If a new property is created with a non-empty value or an existing property is altered: Mutate
145	1	if ($created ? !empty($value) : !$this->assertEquals($data, $value)) {
146	1	$data = $value;
147	1	return new static($propertyTree, $this->object);
148		}
149
150	1	return $this;
151		}
152
153		/**
154		* Traverse the property tree and return a possibly node
155		*
156		* @param array $propertyPath Property name path
157		* @param array $propertyTree Copy of the current property tree
158		* @param boolean $created Property has been created
159		* @return mixed Property node
160		*/
161	1	protected function &findPropertyNode(
162		array $propertyPath,
163		array &$propertyTree,
164		&$created
165		) {
166	1	$data =& $propertyTree;
167
168		// Run through all sub-properties
169	1	foreach ($propertyPath as $property) {
170		// Create the sub-property if it doesn't exist
171	1	if (!array_key_exists($property, $data)) {
172	1	$data[$property] = [];
173	1	$created = true;
174	1	}
175
176	1	$data =& $data[$property];
177	1	}
178
179	1	return $data;
180		}
181
182		/**
183		* Assert that two values equal
184		*
185		* @param mixed $expected Expected value
186		* @param mixed $actual Actual value
187		* @return boolean Actual value equals the expected one
188		*/
189	2	protected function assertEquals($expected, $actual)
190		{
191		// If both values don't have the same type
192	2	if (gettype($expected) !== gettype($actual)) {
193	1	return false;
194		}
195
196		// If we are comparing arrays
197	2	if (is_array($expected)) {
198	1	return ArrayUtility::reduce($expected) == ArrayUtility::reduce($actual);
199		}
200
201		// Compare the values
202	2	return $expected == $actual;
203		}
204		}
205

apparat / object

Push — master ( 027918...a3ee43 )

AbstractGenericProperties::setProperty() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like