ResourceIdentifierObject::primaryId() - Code Metrics - Inspection of "Support local ids" - lode/jsonapi - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Pull Request — main (#53)

by Lode

created 2021-05-14 15:04 UTC

ResourceIdentifierObject::primaryId() A

↳ Parent: ResourceIdentifierObject

Complexity

Conditions	2
Paths	2

Size

Total Lines	6
Code Lines	3

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	4
CRAP Score	2

Importance

Changes	1
Bugs	0	Features	0

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

<?php

namespace alsvanzelf\jsonapi\objects;

use alsvanzelf\jsonapi\exceptions\Exception;
use alsvanzelf\jsonapi\exceptions\DuplicateException;
use alsvanzelf\jsonapi\helpers\AtMemberManager;
use alsvanzelf\jsonapi\helpers\Validator;
use alsvanzelf\jsonapi\interfaces\ObjectInterface;
use alsvanzelf\jsonapi\interfaces\ResourceInterface;
use alsvanzelf\jsonapi\objects\MetaObject;

class ResourceIdentifierObject implements ObjectInterface, ResourceInterface {
	use AtMemberManager;
	
	/** @var string */
	protected $type;
	/** @var string */
	protected $id;
	/** @var string */
	protected $lid;
	/** @var MetaObject */
	protected $meta;
	/** @var Validator */
	protected $validator;
	
	/**
	 * @note $type and $id are optional to pass during construction
	 *       however they are required for a valid ResourceIdentifierObject
	 *       so use ->setType() and ->setId() if not passing them during construction
	 * 
	 * @param string     $type optional
	 * @param string|int $id   optional
	 */
	public function __construct($type=null, $id=null) {
		$this->validator = new Validator();
		
		if ($type !== null) {
			$this->setType($type);
		}
		if ($id !== null) {
			$this->setId($id);
		}
		
		// always mark as used, as these keys are reserved
		$this->validator->claimUsedFields($fieldNames=['type'], Validator::OBJECT_CONTAINER_TYPE);
		$this->validator->claimUsedFields($fieldNames=['id'], Validator::OBJECT_CONTAINER_ID);
		$this->validator->claimUsedFields($fieldNames=['lid'], Validator::OBJECT_CONTAINER_LID);
	}
	
	/**
	 * human api
	 */
	
	/**
	 * @param string $key
	 * @param mixed  $value
	 */
	public function addMeta($key, $value) {
		if ($this->meta === null) {
			$this->setMetaObject(new MetaObject());
		}
		
		$this->meta->add($key, $value);
	}
	
	/**
	 * spec api
	 */
	
	/**
	 * @param string $type
	 */
	public function setType($type) {
		$this->type = $type;
	}
	
	/**
	 * @param string|int $id will be casted to a string
	 * 
	 * @throws DuplicateException if localId is already set
	 */
	public function setId($id) {
		if ($this->lid !== null) {
			throw new DuplicateException('id is not allowed when localId is already set');
		}
		
		$this->id = (string) $id;
	}
	
	/**
	 * set a local id to connect resources to each other when created on the client
	 * 
	 * @note this should not be used to send back from the server to the client
	 * 
	 * @param string|int $localId will be casted to a string
	 * 
	 * @throws DuplicateException if normal id is already set
	 */
	public function setLocalId($localId) {
		if ($this->id !== null) {
			throw new DuplicateException('localId is not allowed when id is already set');
		}
		
		$this->lid = (string) $localId;
	}
	
	/**
	 * @param MetaObject $metaObject
	 */
	public function setMetaObject(MetaObject $metaObject) {
		$this->meta = $metaObject;
	}
	
	/**
	 * internal api
	 */
	
	/**
	 * @internal
	 * 
	 * @param  ResourceObject $resourceObject
	 * @return ResourceIdentifierObject
	 */
	public static function fromResourceObject(ResourceObject $resourceObject) {
		$resourceIdentifierObject = new self($resourceObject->type, $resourceObject->primaryId());
		
		if ($resourceObject->meta !== null) {
			$resourceIdentifierObject->setMetaObject($resourceObject->meta);
		}
		
		return $resourceIdentifierObject;
	}
	
	/**
	 * @internal
	 * 
	 * @param  ResourceInterface $resource
	 * @return boolean
	 * 
	 * @throws Exception if one or both are missing identification
	 */
	public function equals(ResourceInterface $resource) {
		if ($this->hasIdentification() === false || $resource->getResource()->hasIdentification() === false) {
			throw new Exception('can not compare resources if identification is missing');
		}
		
		return ($this->getIdentificationKey() === $resource->getResource()->getIdentificationKey());
	}
	
	/**
	 * @internal
	 * 
	 * @return boolean
	 */
	public function hasIdentification() {
		return ($this->type !== null && $this->primaryId() !== null);
	}
	
	/**
	 * get a key to uniquely define this resource
	 * 
	 * @internal
	 * 
	 * @return string
	 * 
	 * @throws Exception if type or id is not set yet
	 */
	public function getIdentificationKey() {
		if ($this->hasIdentification() === false) {
			throw new Exception('resource has no identification yet');
		}
		
		return $this->type.'|'.$this->primaryId();
	}
	
	/**
	 * ObjectInterface
	 */
	
	/**
	 * @inheritDoc
	 */
	public function isEmpty() {
		if ($this->type !== null || $this->primaryId() !== null) {

			return false;
		}
		if ($this->meta !== null && $this->meta->isEmpty() === false) {
			return false;
		}
		if ($this->hasAtMembers()) {
			return false;
		}
		
		return true;
	}
	
	/**
	 * @inheritDoc
	 */
	public function toArray() {
		$array = $this->getAtMembers();
		
		$array['type'] = $this->type;
		
		if ($this->id !== null) {
			$array['id'] = $this->id;
		}
		elseif ($this->lid !== null) {
			$array['lid'] = $this->lid;
		}
		
		if ($this->meta !== null && $this->meta->isEmpty() === false) {
			$array['meta'] = $this->meta->toArray();
		}
		
		return $array;
	}
	
	/**
	 * ResourceInterface
	 */
	
	/**
	 * @inheritDoc
	 */
	public function getResource($identifierOnly=false) {
		return $this;
	}
	
	/**
	 * @internal
	 */
	
	private function primaryId() {
		if ($this->lid !== null) {
			return $this->lid;
		}
		
		return $this->id;
	}
}


1		<?php
2
3		namespace alsvanzelf\jsonapi\objects;
4
5		use alsvanzelf\jsonapi\exceptions\Exception;
6		use alsvanzelf\jsonapi\exceptions\DuplicateException;
7		use alsvanzelf\jsonapi\helpers\AtMemberManager;
8		use alsvanzelf\jsonapi\helpers\Validator;
9		use alsvanzelf\jsonapi\interfaces\ObjectInterface;
10		use alsvanzelf\jsonapi\interfaces\ResourceInterface;
11		use alsvanzelf\jsonapi\objects\MetaObject;
12
13		class ResourceIdentifierObject implements ObjectInterface, ResourceInterface {
14		use AtMemberManager;
15
16		/** @var string */
17		protected $type;
18		/** @var string */
19		protected $id;
20		/** @var string */
21		protected $lid;
22		/** @var MetaObject */
23		protected $meta;
24		/** @var Validator */
25		protected $validator;
26
27		/**
28		* @note $type and $id are optional to pass during construction
29		* however they are required for a valid ResourceIdentifierObject
30		* so use ->setType() and ->setId() if not passing them during construction
31		*
32		* @param string $type optional
33		* @param string\|int $id optional
34		*/
35	89	public function __construct($type=null, $id=null) {
36	89	$this->validator = new Validator();
37
38	89	if ($type !== null) {
39	75	$this->setType($type);
40		}
41	89	if ($id !== null) {
42	70	$this->setId($id);
43		}
44
45		// always mark as used, as these keys are reserved
46	89	$this->validator->claimUsedFields($fieldNames=['type'], Validator::OBJECT_CONTAINER_TYPE);
47	89	$this->validator->claimUsedFields($fieldNames=['id'], Validator::OBJECT_CONTAINER_ID);
48	89	$this->validator->claimUsedFields($fieldNames=['lid'], Validator::OBJECT_CONTAINER_LID);
49	89	}
50
51		/**
52		* human api
53		*/
54
55		/**
56		* @param string $key
57		* @param mixed $value
58		*/
59	7	public function addMeta($key, $value) {
60	7	if ($this->meta === null) {
61	7	$this->setMetaObject(new MetaObject());
62		}
63
64	7	$this->meta->add($key, $value);
65	7	}
66
67		/**
68		* spec api
69		*/
70
71		/**
72		* @param string $type
73		*/
74	81	public function setType($type) {
75	81	$this->type = $type;
76	81	}
77
78		/**
79		* @param string\|int $id will be casted to a string
80		*
81		* @throws DuplicateException if localId is already set
82		*/
83	74	public function setId($id) {
84	74	if ($this->lid !== null) {
85	1	throw new DuplicateException('id is not allowed when localId is already set');
86		}
87
88	73	$this->id = (string) $id;
89	73	}
90
91		/**
92		* set a local id to connect resources to each other when created on the client
93		*
94		* @note this should not be used to send back from the server to the client
95		*
96		* @param string\|int $localId will be casted to a string
97		*
98		* @throws DuplicateException if normal id is already set
99		*/
100	5	public function setLocalId($localId) {
101	5	if ($this->id !== null) {
102	1	throw new DuplicateException('localId is not allowed when id is already set');
103		}
104
105	4	$this->lid = (string) $localId;
106	4	}
107
108		/**
109		* @param MetaObject $metaObject
110		*/
111	8	public function setMetaObject(MetaObject $metaObject) {
112	8	$this->meta = $metaObject;
113	8	}
114
115		/**
116		* internal api
117		*/
118
119		/**
120		* @internal
121		*
122		* @param ResourceObject $resourceObject
123		* @return ResourceIdentifierObject
124		*/
125	35	public static function fromResourceObject(ResourceObject $resourceObject) {
126	35	$resourceIdentifierObject = new self($resourceObject->type, $resourceObject->primaryId());
127
128	35	if ($resourceObject->meta !== null) {
129	2	$resourceIdentifierObject->setMetaObject($resourceObject->meta);
130		}
131
132	35	return $resourceIdentifierObject;
133		}
134
135		/**
136		* @internal
137		*
138		* @param ResourceInterface $resource
139		* @return boolean
140		*
141		* @throws Exception if one or both are missing identification
142		*/
143	23	public function equals(ResourceInterface $resource) {
144	23	if ($this->hasIdentification() === false \|\| $resource->getResource()->hasIdentification() === false) {
145	1	throw new Exception('can not compare resources if identification is missing');
146		}
147
148	22	return ($this->getIdentificationKey() === $resource->getResource()->getIdentificationKey());
149		}
150
151		/**
152		* @internal
153		*
154		* @return boolean
155		*/
156	44	public function hasIdentification() {
157	44	return ($this->type !== null && $this->primaryId() !== null);
158		}
159
160		/**
161		* get a key to uniquely define this resource
162		*
163		* @internal
164		*
165		* @return string
166		*
167		* @throws Exception if type or id is not set yet
168		*/
169	41	public function getIdentificationKey() {
170	41	if ($this->hasIdentification() === false) {
171	2	throw new Exception('resource has no identification yet');
172		}
173
174	39	return $this->type.'\|'.$this->primaryId();
175		}
176
177		/**
178		* ObjectInterface
179		*/
180
181		/**
182		* @inheritDoc
183		*/
184	44	public function isEmpty() {
185	44	if ($this->type !== null \|\| $this->primaryId() !== null) {
		1 ignored issue – show introduced 2021-05-14 14:40 UTC by Report Bug Copy Issue Report The condition `$this->primaryId() !== null` is always `true`. Loading history...
186	36	return false;
187		}
188	9	if ($this->meta !== null && $this->meta->isEmpty() === false) {
189	1	return false;
190		}
191	8	if ($this->hasAtMembers()) {
192	1	return false;
193		}
194
195	8	return true;
196		}
197
198		/**
199		* @inheritDoc
200		*/
201	62	public function toArray() {
202	62	$array = $this->getAtMembers();
203
204	62	$array['type'] = $this->type;
205
206	62	if ($this->id !== null) {
207	54	$array['id'] = $this->id;
208		}
209	10	elseif ($this->lid !== null) {
210	2	$array['lid'] = $this->lid;
211		}
212
213	62	if ($this->meta !== null && $this->meta->isEmpty() === false) {
214	7	$array['meta'] = $this->meta->toArray();
215		}
216
217	62	return $array;
218		}
219
220		/**
221		* ResourceInterface
222		*/
223
224		/**
225		* @inheritDoc
226		*/
227	9	public function getResource($identifierOnly=false) {
228	9	return $this;
229		}
230
231		/**
232		* @internal
233		*/
234
235	62	private function primaryId() {
236	62	if ($this->lid !== null) {
237	2	return $this->lid;
238		}
239
240	60	return $this->id;
241		}
242		}
243

lode / jsonapi

Pull Request — main (#53)

ResourceIdentifierObject::primaryId() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like