Property::__clone() - Code Metrics - Inspection of "Remove non-critical type checks from AliasGroupLis..." - wmde/WikibaseDataModel - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — langAssertions ( 0e6369...680829 )

by no

created 2016-03-08 10:16 UTC

Property::__clone() A

↳ Parent: Property

Complexity

Conditions	1
Paths	1

Size

Total Lines	4
Code Lines	3

Duplication

Lines	0
Ratio	0 %

Importance

Changes	1
Bugs	0	Features	1

Metric	Value
c	1
b	0
f	1
dl	0
loc	4
rs	10
nc	1
cc	1
eloc	3
nop	0

<?php

namespace Wikibase\DataModel\Entity;

use InvalidArgumentException;
use Wikibase\DataModel\Statement\StatementList;
use Wikibase\DataModel\Statement\StatementListHolder;
use Wikibase\DataModel\Term\Fingerprint;

/**
 * Represents a single Wikibase property.
 * See https://www.mediawiki.org/wiki/Wikibase/DataModel#Properties
 *
 * @since 0.1
 *
 * @licence GNU GPL v2+
 * @author Jeroen De Dauw < [email protected] >
 */
class Property extends Entity implements StatementListHolder {


	const ENTITY_TYPE = 'property';

	/**
	 * @var PropertyId|null
	 */
	private $id;

	/**
	 * @var Fingerprint
	 */
	private $fingerprint;

	/**
	 * @var string The data type of the property.
	 */
	private $dataTypeId;

	/**
	 * @var StatementList
	 */
	private $statements;

	/**
	 * @since 1.0
	 *
	 * @param PropertyId|null $id
	 * @param Fingerprint|null $fingerprint
	 * @param string $dataTypeId The data type of the property. Not to be confused with the data
	 *  value type.
	 * @param StatementList|null $statements Since 1.1
	 */
	public function __construct(
		PropertyId $id = null,
		Fingerprint $fingerprint = null,
		$dataTypeId,
		StatementList $statements = null
	) {
		$this->id = $id;
		$this->fingerprint = $fingerprint ?: new Fingerprint();
		$this->setDataTypeId( $dataTypeId );
		$this->statements = $statements ?: new StatementList();
	}

	/**
	 * Returns the id of the entity or null if it does not have one.
	 *
	 * @since 0.1 return type changed in 0.3
	 *
	 * @return PropertyId|null
	 */
	public function getId() {
		return $this->id;
	}

	/**
	 * Can be integer since 0.1.
	 * Can be PropertyId since 0.5.
	 * Can be null since 1.0.
	 *
	 * @param PropertyId|int|null $id
	 *
	 * @throws InvalidArgumentException
	 */
	public function setId( $id ) {
		if ( $id === null || $id instanceof PropertyId ) {
			$this->id = $id;
		} elseif ( is_int( $id ) ) {
			$this->id = PropertyId::newFromNumber( $id );
		} else {
			throw new InvalidArgumentException( '$id must be an instance of PropertyId, an integer,'
				. ' or null' );
		}
	}

	/**
	 * @since 0.7.3
	 *
	 * @return Fingerprint
	 */
	public function getFingerprint() {
		return $this->fingerprint;
	}

	/**
	 * @since 0.7.3
	 *
	 * @param Fingerprint $fingerprint
	 */
	public function setFingerprint( Fingerprint $fingerprint ) {
		$this->fingerprint = $fingerprint;
	}

	/**
	 * @param string $languageCode
	 * @param string $value
	 *
	 * @throws InvalidArgumentException
	 */
	public function setLabel( $languageCode, $value ) {
		$this->fingerprint->setLabel( $languageCode, $value );
	}

	/**
	 * @param string $languageCode
	 * @param string $value
	 *
	 * @throws InvalidArgumentException
	 */
	public function setDescription( $languageCode, $value ) {
		$this->fingerprint->setDescription( $languageCode, $value );
	}

	/**
	 * @param string $languageCode
	 * @param string[] $aliases
	 *
	 * @throws InvalidArgumentException
	 */
	public function setAliases( $languageCode, array $aliases ) {
		$this->fingerprint->setAliasGroup( $languageCode, $aliases );
	}

	/**
	 * @since 0.4
	 *
	 * @param string $dataTypeId The data type of the property. Not to be confused with the data
	 *  value type.
	 *
	 * @throws InvalidArgumentException
	 */
	public function setDataTypeId( $dataTypeId ) {
		if ( !is_string( $dataTypeId ) ) {
			throw new InvalidArgumentException( '$dataTypeId must be a string' );
		}

		$this->dataTypeId = $dataTypeId;
	}

	/**
	 * @since 0.4
	 *
	 * @return string Returns the data type of the property (property type). Not to be confused with
	 *  the data value type.
	 */
	public function getDataTypeId() {
		return $this->dataTypeId;
	}

	/**
	 * @see Entity::getType
	 *
	 * @since 0.1
	 *
	 * @return string Returns the entity type "property".
	 */
	public function getType() {
		return self::ENTITY_TYPE;
	}

	/**
	 * @since 0.3
	 *
	 * @param string $dataTypeId The data type of the property. Not to be confused with the data
	 *  value type.
	 *
	 * @return self
	 */
	public static function newFromType( $dataTypeId ) {
		return new self( null, null, $dataTypeId );
	}

	/**
	 * @see EntityDocument::equals
	 *
	 * @since 0.1
	 *
	 * @param mixed $target
	 *
	 * @return bool
	 */
	public function equals( $target ) {
		if ( $this === $target ) {
			return true;
		}

		return $target instanceof self
			&& $this->dataTypeId === $target->dataTypeId
			&& $this->fingerprint->equals( $target->fingerprint )
			&& $this->statements->equals( $target->statements );
	}

	/**
	 * Returns if the Property has no content.
	 * Having an id and type set does not count as having content.
	 *
	 * @since 0.1
	 *
	 * @return bool
	 */
	public function isEmpty() {
		return $this->fingerprint->isEmpty()
			&& $this->statements->isEmpty();
	}

	/**
	 * Removes all content from the Property.
	 * The id and the type are not part of the content.
	 *
	 * @since 0.1
	 */
	public function clear() {
		$this->fingerprint = new Fingerprint();
		$this->statements = new StatementList();
	}

	/**
	 * @since 1.1
	 *
	 * @return StatementList
	 */
	public function getStatements() {
		return $this->statements;
	}

	/**
	 * @since 1.1
	 *
	 * @param StatementList $statements
	 */
	public function setStatements( StatementList $statements ) {
		$this->statements = $statements;
	}

	/**
	 * @see EntityDocument::copy
	 *
	 * @since 0.1
	 *
	 * @return self
	 */
	public function copy() {
		return clone $this;
	}

	/**
	 * @see http://php.net/manual/en/language.oop5.cloning.php
	 *
	 * @since 5.1
	 */
	public function __clone() {
		$this->fingerprint = clone $this->fingerprint;
		$this->statements = clone $this->statements;
	}

}


1			<?php
2
3			namespace Wikibase\DataModel\Entity;
4
5			use InvalidArgumentException;
6			use Wikibase\DataModel\Statement\StatementList;
7			use Wikibase\DataModel\Statement\StatementListHolder;
8			use Wikibase\DataModel\Term\Fingerprint;
9
10			/**
11			* Represents a single Wikibase property.
12			* See https://www.mediawiki.org/wiki/Wikibase/DataModel#Properties
13			*
14			* @since 0.1
15			*
16			* @licence GNU GPL v2+
17			* @author Jeroen De Dauw < [email protected] >
18			*/
19			class Property extends Entity implements StatementListHolder {
			0 ignored issues – show Deprecated Code introduced 2015-11-27 17:36 UTC by Report Bug Copy Issue Report The class `Wikibase\DataModel\Entity\Entity` has been deprecated with message: since 1.0 - do not type hint against Entity. See https://lists.wikimedia.org/pipermail/wikidata-tech/2014-June/000489.html This class, trait or interface has been deprecated. The supplier of the file has supplied an explanatory message. The explanatory message should give you some clue as to whether and when the type will be removed from the class and what other constant to use instead. Loading history... Deprecated Code introduced 2016-03-02 14:17 UTC by Report Bug Copy Issue Report The interface `Wikibase\DataModel\Statement\StatementListHolder` has been deprecated with message: since 5.1, will be removed in 6.0 in favor of StatementListProvider, which will then give the guarantee to return an object by reference. Changes to that object change the entity. This class, trait or interface has been deprecated. The supplier of the file has supplied an explanatory message. The explanatory message should give you some clue as to whether and when the type will be removed from the class and what other constant to use instead. Loading history...
20
21			const ENTITY_TYPE = 'property';
22
23			/**
24			* @var PropertyId\|null
25			*/
26			private $id;
27
28			/**
29			* @var Fingerprint
30			*/
31			private $fingerprint;
32
33			/**
34			* @var string The data type of the property.
35			*/
36			private $dataTypeId;
37
38			/**
39			* @var StatementList
40			*/
41			private $statements;
42
43			/**
44			* @since 1.0
45			*
46			* @param PropertyId\|null $id
47			* @param Fingerprint\|null $fingerprint
48			* @param string $dataTypeId The data type of the property. Not to be confused with the data
49			* value type.
50			* @param StatementList\|null $statements Since 1.1
51			*/
52			public function __construct(
53			PropertyId $id = null,
54			Fingerprint $fingerprint = null,
55			$dataTypeId,
56			StatementList $statements = null
57			) {
58			$this->id = $id;
59			$this->fingerprint = $fingerprint ?: new Fingerprint();
60			$this->setDataTypeId( $dataTypeId );
61			$this->statements = $statements ?: new StatementList();
62			}
63
64			/**
65			* Returns the id of the entity or null if it does not have one.
66			*
67			* @since 0.1 return type changed in 0.3
68			*
69			* @return PropertyId\|null
70			*/
71			public function getId() {
72			return $this->id;
73			}
74
75			/**
76			* Can be integer since 0.1.
77			* Can be PropertyId since 0.5.
78			* Can be null since 1.0.
79			*
80			* @param PropertyId\|int\|null $id
81			*
82			* @throws InvalidArgumentException
83			*/
84			public function setId( $id ) {
85			if ( $id === null \|\| $id instanceof PropertyId ) {
86			$this->id = $id;
87			} elseif ( is_int( $id ) ) {
88			$this->id = PropertyId::newFromNumber( $id );
89			} else {
90			throw new InvalidArgumentException( '$id must be an instance of PropertyId, an integer,'
91			. ' or null' );
92			}
93			}
94
95			/**
96			* @since 0.7.3
97			*
98			* @return Fingerprint
99			*/
100			public function getFingerprint() {
101			return $this->fingerprint;
102			}
103
104			/**
105			* @since 0.7.3
106			*
107			* @param Fingerprint $fingerprint
108			*/
109			public function setFingerprint( Fingerprint $fingerprint ) {
110			$this->fingerprint = $fingerprint;
111			}
112
113			/**
114			* @param string $languageCode
115			* @param string $value
116			*
117			* @throws InvalidArgumentException
118			*/
119			public function setLabel( $languageCode, $value ) {
120			$this->fingerprint->setLabel( $languageCode, $value );
121			}
122
123			/**
124			* @param string $languageCode
125			* @param string $value
126			*
127			* @throws InvalidArgumentException
128			*/
129			public function setDescription( $languageCode, $value ) {
130			$this->fingerprint->setDescription( $languageCode, $value );
131			}
132
133			/**
134			* @param string $languageCode
135			* @param string[] $aliases
136			*
137			* @throws InvalidArgumentException
138			*/
139			public function setAliases( $languageCode, array $aliases ) {
140			$this->fingerprint->setAliasGroup( $languageCode, $aliases );
141			}
142
143			/**
144			* @since 0.4
145			*
146			* @param string $dataTypeId The data type of the property. Not to be confused with the data
147			* value type.
148			*
149			* @throws InvalidArgumentException
150			*/
151			public function setDataTypeId( $dataTypeId ) {
152			if ( !is_string( $dataTypeId ) ) {
153			throw new InvalidArgumentException( '$dataTypeId must be a string' );
154			}
155
156			$this->dataTypeId = $dataTypeId;
157			}
158
159			/**
160			* @since 0.4
161			*
162			* @return string Returns the data type of the property (property type). Not to be confused with
163			* the data value type.
164			*/
165			public function getDataTypeId() {
166			return $this->dataTypeId;
167			}
168
169			/**
170			* @see Entity::getType
171			*
172			* @since 0.1
173			*
174			* @return string Returns the entity type "property".
175			*/
176			public function getType() {
177			return self::ENTITY_TYPE;
178			}
179
180			/**
181			* @since 0.3
182			*
183			* @param string $dataTypeId The data type of the property. Not to be confused with the data
184			* value type.
185			*
186			* @return self
187			*/
188			public static function newFromType( $dataTypeId ) {
189			return new self( null, null, $dataTypeId );
190			}
191
192			/**
193			* @see EntityDocument::equals
194			*
195			* @since 0.1
196			*
197			* @param mixed $target
198			*
199			* @return bool
200			*/
201			public function equals( $target ) {
202			if ( $this === $target ) {
203			return true;
204			}
205
206			return $target instanceof self
207			&& $this->dataTypeId === $target->dataTypeId
208			&& $this->fingerprint->equals( $target->fingerprint )
209			&& $this->statements->equals( $target->statements );
210			}
211
212			/**
213			* Returns if the Property has no content.
214			* Having an id and type set does not count as having content.
215			*
216			* @since 0.1
217			*
218			* @return bool
219			*/
220			public function isEmpty() {
221			return $this->fingerprint->isEmpty()
222			&& $this->statements->isEmpty();
223			}
224
225			/**
226			* Removes all content from the Property.
227			* The id and the type are not part of the content.
228			*
229			* @since 0.1
230			*/
231			public function clear() {
232			$this->fingerprint = new Fingerprint();
233			$this->statements = new StatementList();
234			}
235
236			/**
237			* @since 1.1
238			*
239			* @return StatementList
240			*/
241			public function getStatements() {
242			return $this->statements;
243			}
244
245			/**
246			* @since 1.1
247			*
248			* @param StatementList $statements
249			*/
250			public function setStatements( StatementList $statements ) {
251			$this->statements = $statements;
252			}
253
254			/**
255			* @see EntityDocument::copy
256			*
257			* @since 0.1
258			*
259			* @return self
260			*/
261			public function copy() {
262			return clone $this;
263			}
264
265			/**
266			* @see http://php.net/manual/en/language.oop5.cloning.php
267			*
268			* @since 5.1
269			*/
270			public function __clone() {
271			$this->fingerprint = clone $this->fingerprint;
272			$this->statements = clone $this->statements;
273			}
274
275			}
276

wmde / WikibaseDataModel

Push — langAssertions ( 0e6369...680829 )

Property::__clone() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like