Registry::add() - Code Metrics - brickoo/components - Measure and Improve Code Quality continuously with Scrutinizer

Registry::add() A
last analyzed 2017-05-19 11:35 UTC

↳ Parent: Registry

Complexity

Conditions	4
Paths	4

Size

Total Lines	10
Code Lines	6

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	8
CRAP Score	4

Importance

Changes

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

<?php

/*
 * Copyright (c) 2011-2015, Celestino Diaz <[email protected]>
 *
 * 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 Brickoo\Component\Common;

use Brickoo\Component\Common\Exception\DuplicateRegistrationException;
use Brickoo\Component\Common\Exception\IdentifierLockedException;
use Brickoo\Component\Common\Exception\IdentifierNotRegisteredException;
use Brickoo\Component\Common\Exception\ReadonlyModeException;
use Brickoo\Component\Common\Assert;

/**
 * Registry
 *
 * Registrations are stored as key value pairs.
 * Provides getter and setter for accessing the registrations.
 * Provides lock functionality for each identifier and an read only mode for all identifiers.
 * @author Celestino Diaz <[email protected]>
 */
class Registry extends Locker {

    /** @var array */
    protected $registrations;

    /** @var boolean */
    protected $readOnly;

    /**
     * Class constructor.
     * @param array $registrations the registrations to add
     * @param boolean $readOnly initialize mode for the registry
     */
    public function __construct(array $registrations = [], $readOnly = false) {
        parent::__construct();
        $this->registrations = $registrations;
        $this->readOnly = (!empty($registrations)) && (boolean)$readOnly;
    }

    /**
     * Return all assigned registrations as an array.
     * @return array
     */
    public function toArray() {
        return $this->registrations;
    }

    /**
     * Add a registration to the registry.
     * @param mixed $registrations the registrations to add
     * @throws \InvalidArgumentException if passed registrations is empty
     * @return \Brickoo\Component\Common\Registry
     */
    public function add($registrations) {
        if ((!is_array($registrations)) && (!$registrations instanceof \Traversable)) {
            $registrations = [$registrations];
        }

        foreach ($registrations as $identifier => $value) {
            $this->register($identifier, $value);
        }
        return $this;
    }

    /**
     * Return the registered value from the given identifier.
     * @param string $identifier the identifier so retrieve the value from
     * @throws \InvalidArgumentException if the identifier is not valid
     * @throws \Brickoo\Component\Common\Exception\IdentifierNotRegisteredException
     * @return mixed
     */
    public function get($identifier) {
        Assert::isStringOrInteger($identifier);

        if (!$this->isRegistered($identifier)) {
            throw new IdentifierNotRegisteredException($identifier);
        }

        return $this->registrations[$identifier];
    }

    /**
     * Register an identifier-value pair.
     * Take care of registering objects who are assigned somewhere else
     * as an reference the changes applies to the registered objects as well.
     * @param string $identifier the identifier to register
     * @param mixed $value the identifier value to register with
     * @throws \Brickoo\Component\Common\Exception\DuplicateRegistrationException
     * @throws \Brickoo\Component\Common\Exception\ReadonlyModeException
     * @return \Brickoo\Component\Common\Registry
     */
    public function register($identifier, $value) {
        Assert::isStringOrInteger($identifier);

        if ($this->isRegistered($identifier)) {
            throw new DuplicateRegistrationException($identifier);
        }

        $this->set($identifier, $value);
        return $this;
    }

    /**
     * Overrides an existing identifier with the new value (!).
     * If the identifier ist not registered it will be registered.
     * @param string $identifier the identifier to register
     * @param mixed $value the identifier value to register
     * @throws \Brickoo\Component\Common\Exception\ReadonlyModeException
     * @throws \Brickoo\Component\Common\Exception\IdentifierLockedException
     * @return \Brickoo\Component\Common\Registry
     */
    public function override($identifier, $value) {
        Assert::isStringOrInteger($identifier);

        if ($this->isLocked($identifier)) {
            throw new IdentifierLockedException($identifier);
        }

        $this->set($identifier, $value);
        return $this;
    }

    /**
     * Unregister the identifier and his value.
     * @param string $identifier the identifier to unregister
     * @throws \Brickoo\Component\Common\Exception\ReadonlyModeException
     * @throws \Brickoo\Component\Common\Exception\IdentifierLockedException
     * @throws \Brickoo\Component\Common\Exception\IdentifierNotRegisteredException
     * @return \Brickoo\Component\Common\Registry
     */
    public function unregister($identifier) {
        Assert::isStringOrInteger($identifier);

        if ($this->isReadOnly()) {
            throw new ReadonlyModeException();
        }

        if ($this->isLocked($identifier)) {
            throw new IdentifierLockedException($identifier);
        }

        if (!$this->isRegistered($identifier)) {
            throw new IdentifierNotRegisteredException($identifier);
        }

        unset ($this->registrations[$identifier]);
        return $this;
    }

    /**
     * Check if the identifier is registered.
     * @param string $identifier the identifier to check
     * @return boolean
     */
    public function isRegistered($identifier) {
        Assert::isStringOrInteger($identifier);
        return array_key_exists($identifier, $this->registrations);
    }

    /**
     * Sets the read only mode for all registrations.
     * True to allow read only, write operations will be not allowed.
     * False for enable read and write operations, locked identifiers will still being locked .
     * @param boolean $mode the mode to set
     * @return \Brickoo\Component\Common\Registry
     */
    public function setReadOnly($mode = true) {
        Assert::isBoolean($mode);

        $this->readOnly = $mode;
        return $this;
    }

    /**
     * Check if the mode is currently set to read only.
     * @return boolean
     */
    public function isReadOnly() {
        return $this->readOnly;
    }

    /**
     * Countable interface implementation.
     * Returns the number of registrations.
     * @see Countable::count()
     * @return integer
     */
    public function count() {
        return count($this->registrations);
    }

    /**
     * Returns the number of locked identifiers.
     * @return integer
     */
    public function countLocked() {
        return count($this->locked);
    }

    /** {@inheritDoc} */
    public function isIdentifierAvailable($identifier) {
        return $this->isRegistered($identifier);
    }

    /**
     * Set the registered identifier and value.
     * @param string $identifier
     * @param mixed $value
     * @throws Exception\DuplicateRegistrationException
     * @throws Exception\ReadonlyModeException
     * @return \Brickoo\Component\Common\Registry
     */
    private function set($identifier, $value) {
        if ($this->isReadOnly()) {
            throw new ReadonlyModeException();
        }

        $this->registrations[$identifier] = $value;
        return $this;
    }

}


1		<?php
2
3		/*
4		* Copyright (c) 2011-2015, Celestino Diaz <[email protected]>
5		*
6		* Permission is hereby granted, free of charge, to any person obtaining a copy
7		* of this software and associated documentation files (the "Software"), to deal
8		* in the Software without restriction, including without limitation the rights
9		* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10		* copies of the Software, and to permit persons to whom the Software is
11		* furnished to do so, subject to the following conditions:
12		*
13		* The above copyright notice and this permission notice shall be included in
14		* all copies or substantial portions of the Software.
15		*
16		* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17		* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18		* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19		* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20		* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21		* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22		* THE SOFTWARE.
23		*/
24
25		namespace Brickoo\Component\Common;
26
27		use Brickoo\Component\Common\Exception\DuplicateRegistrationException;
28		use Brickoo\Component\Common\Exception\IdentifierLockedException;
29		use Brickoo\Component\Common\Exception\IdentifierNotRegisteredException;
30		use Brickoo\Component\Common\Exception\ReadonlyModeException;
31		use Brickoo\Component\Common\Assert;
32
33		/**
34		* Registry
35		*
36		* Registrations are stored as key value pairs.
37		* Provides getter and setter for accessing the registrations.
38		* Provides lock functionality for each identifier and an read only mode for all identifiers.
39		* @author Celestino Diaz <[email protected]>
40		*/
41		class Registry extends Locker {
42
43		/** @var array */
44		protected $registrations;
45
46		/** @var boolean */
47		protected $readOnly;
48
49		/**
50		* Class constructor.
51		* @param array $registrations the registrations to add
52		* @param boolean $readOnly initialize mode for the registry
53		*/
54	1	public function __construct(array $registrations = [], $readOnly = false) {
55	1	parent::__construct();
56	1	$this->registrations = $registrations;
57	1	$this->readOnly = (!empty($registrations)) && (boolean)$readOnly;
58	1	}
59
60		/**
61		* Return all assigned registrations as an array.
62		* @return array
63		*/
64	1	public function toArray() {
65	1	return $this->registrations;
66		}
67
68		/**
69		* Add a registration to the registry.
70		* @param mixed $registrations the registrations to add
71		* @throws \InvalidArgumentException if passed registrations is empty
72		* @return \Brickoo\Component\Common\Registry
73		*/
74	3	public function add($registrations) {
75	3	if ((!is_array($registrations)) && (!$registrations instanceof \Traversable)) {
76	1	$registrations = [$registrations];
77	1	}
78
79	3	foreach ($registrations as $identifier => $value) {
80	3	$this->register($identifier, $value);
81	3	}
82	3	return $this;
83		}
84
85		/**
86		* Return the registered value from the given identifier.
87		* @param string $identifier the identifier so retrieve the value from
88		* @throws \InvalidArgumentException if the identifier is not valid
89		* @throws \Brickoo\Component\Common\Exception\IdentifierNotRegisteredException
90		* @return mixed
91		*/
92	2	public function get($identifier) {
93	2	Assert::isStringOrInteger($identifier);
94
95	2	if (!$this->isRegistered($identifier)) {
96	1	throw new IdentifierNotRegisteredException($identifier);
97		}
98
99	1	return $this->registrations[$identifier];
100		}
101
102		/**
103		* Register an identifier-value pair.
104		* Take care of registering objects who are assigned somewhere else
105		* as an reference the changes applies to the registered objects as well.
106		* @param string $identifier the identifier to register
107		* @param mixed $value the identifier value to register with
108		* @throws \Brickoo\Component\Common\Exception\DuplicateRegistrationException
109		* @throws \Brickoo\Component\Common\Exception\ReadonlyModeException
110		* @return \Brickoo\Component\Common\Registry
111		*/
112	3	public function register($identifier, $value) {
113	3	Assert::isStringOrInteger($identifier);
114
115	3	if ($this->isRegistered($identifier)) {
116	1	throw new DuplicateRegistrationException($identifier);
117		}
118
119	3	$this->set($identifier, $value);
120	2	return $this;
121		}
122
123		/**
124		* Overrides an existing identifier with the new value (!).
125		* If the identifier ist not registered it will be registered.
126		* @param string $identifier the identifier to register
127		* @param mixed $value the identifier value to register
128		* @throws \Brickoo\Component\Common\Exception\ReadonlyModeException
129		* @throws \Brickoo\Component\Common\Exception\IdentifierLockedException
130		* @return \Brickoo\Component\Common\Registry
131		*/
132	3	public function override($identifier, $value) {
133	3	Assert::isStringOrInteger($identifier);
134
135	3	if ($this->isLocked($identifier)) {
136	1	throw new IdentifierLockedException($identifier);
137		}
138
139	2	$this->set($identifier, $value);
140	1	return $this;
141		}
142
143		/**
144		* Unregister the identifier and his value.
145		* @param string $identifier the identifier to unregister
146		* @throws \Brickoo\Component\Common\Exception\ReadonlyModeException
147		* @throws \Brickoo\Component\Common\Exception\IdentifierLockedException
148		* @throws \Brickoo\Component\Common\Exception\IdentifierNotRegisteredException
149		* @return \Brickoo\Component\Common\Registry
150		*/
151	4	public function unregister($identifier) {
152	4	Assert::isStringOrInteger($identifier);
153
154	4	if ($this->isReadOnly()) {
155	1	throw new ReadonlyModeException();
156		}
157
158	3	if ($this->isLocked($identifier)) {
159	1	throw new IdentifierLockedException($identifier);
160		}
161
162	2	if (!$this->isRegistered($identifier)) {
163	1	throw new IdentifierNotRegisteredException($identifier);
164		}
165
166	1	unset ($this->registrations[$identifier]);
167	1	return $this;
168		}
169
170		/**
171		* Check if the identifier is registered.
172		* @param string $identifier the identifier to check
173		* @return boolean
174		*/
175	1	public function isRegistered($identifier) {
176	1	Assert::isStringOrInteger($identifier);
177	1	return array_key_exists($identifier, $this->registrations);
178		}
179
180		/**
181		* Sets the read only mode for all registrations.
182		* True to allow read only, write operations will be not allowed.
183		* False for enable read and write operations, locked identifiers will still being locked .
184		* @param boolean $mode the mode to set
185		* @return \Brickoo\Component\Common\Registry
186		*/
187	1	public function setReadOnly($mode = true) {
188	1	Assert::isBoolean($mode);
189
190	1	$this->readOnly = $mode;
191	1	return $this;
192		}
193
194		/**
195		* Check if the mode is currently set to read only.
196		* @return boolean
197		*/
198	2	public function isReadOnly() {
199	2	return $this->readOnly;
200		}
201
202		/**
203		* Countable interface implementation.
204		* Returns the number of registrations.
205		* @see Countable::count()
206		* @return integer
207		*/
208	1	public function count() {
209	1	return count($this->registrations);
210		}
211
212		/**
213		* Returns the number of locked identifiers.
214		* @return integer
215		*/
216	1	public function countLocked() {
217	1	return count($this->locked);
218		}
219
220		/** {@inheritDoc} */
221	1	public function isIdentifierAvailable($identifier) {
222	1	return $this->isRegistered($identifier);
223		}
224
225		/**
226		* Set the registered identifier and value.
227		* @param string $identifier
228		* @param mixed $value
229		* @throws Exception\DuplicateRegistrationException
230		* @throws Exception\ReadonlyModeException
231		* @return \Brickoo\Component\Common\Registry
232		*/
233	3	private function set($identifier, $value) {
234	3	if ($this->isReadOnly()) {
235	2	throw new ReadonlyModeException();
236		}
237
238	2	$this->registrations[$identifier] = $value;
239	2	return $this;
240		}
241
242		}
243

brickoo / components

Registry::add() A last analyzed 2017-05-19 11:35 UTC

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like

Registry::add() A
last analyzed 2017-05-19 11:35 UTC