Add EntityRedirect & Test

This is a copy and paste from Wikibase Lib

Author: addshore

src/Entity/EntityRedirect.php

@@ -0,0 +1,74 @@
+<?php
+
+namespace Wikibase\DataModel\Entity;
+
+use InvalidArgumentException;
+
+/**
+ * Represents a redirect from one EntityId to another.
+ *
+ * @since 4.2
+ *
+ * @licence GNU GPL v2+
+ * @author Daniel Kinzler
+ */
+class EntityRedirect  {
+
+	/**
+	 * @var EntityId
+	 */
+	private $entityId;
+
+	/**
+	 * @var EntityId
+	 */
+	private $targetId;
+
+	/**
+	 * @param EntityId $entityId
+	 * @param EntityId $targetId
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	public function __construct( EntityId $entityId, EntityId $targetId ) {
+		if ( $entityId->getEntityType() !== $targetId->getEntityType() ) {
+			throw new InvalidArgumentException(
+				'$entityId and $targetId must refer to the same kind of entity.'
+			);
+		}
+
+		$this->entityId = $entityId;
+		$this->targetId = $targetId;
+	}
+
+	/**
+	 * @return EntityId
+	 */
+	public function getEntityId() {
+		return $this->entityId;
+	}
+
+	/**
+	 * @return EntityId
+	 */
+	public function getTargetId() {
+		return $this->targetId;
+	}
+
+	/**
+	 * @param EntityRedirect $that
+	 *
+	 * @return bool
+	 */
+	public function equals( $that ) {
+		if ( $that === $this ) {
+			return true;
+		}
+
+		return is_object( $that )
+			&& get_class( $that ) === get_called_class()
+			&& $this->entityId->equals( $that->entityId )
+			&& $this->targetId->equals( $that->targetId );
+	}
+
+}

tests/unit/Entity/EntityRedirectTest.php

@@ -0,0 +1,80 @@
+<?php
+
+namespace Wikibase\DataModel\Tests\Entity;
+
+use Wikibase\DataModel\Entity\EntityRedirect;
+use Wikibase\DataModel\Entity\ItemId;
+use Wikibase\DataModel\Entity\PropertyId;
+
+/**
+ * @covers Wikibase\Lib\Store\EntityRedirect
+ *
+ * @group Wikibase
+ * @group WikibaseDataModel
+ *
+ * @licence GNU GPL v2+
+ * @author Daniel Kinzler
+ */
+class EntityRedirectTest extends \PHPUnit_Framework_TestCase {
+
+	public function testConstruction() {
+		$entityId = new ItemId( 'Q123' );
+		$targetId = new ItemId( 'Q345' );
+
+		$redirect = new EntityRedirect( $entityId, $targetId );
+
+		$this->assertEquals( $entityId, $redirect->getEntityId(), '$redirect->getEntityId()' );
+		$this->assertEquals( $targetId, $redirect->getTargetId(), '$redirect->getTargetId()' );
+	}
+
+	public function testConstruction_baseType() {
+		$this->setExpectedException( 'InvalidArgumentException' );
+
+		$entityId = new ItemId( 'Q123' );
+		$targetId = new PropertyId( 'P345' );
+
+		new EntityRedirect( $entityId, $targetId );
+	}
+
+	public function equalsProvider() {
+		$q123 = new ItemId( 'Q123' );
+		$q345 = new ItemId( 'Q345' );
+		$q567 = new ItemId( 'Q567' );
+		$q123_345 = new EntityRedirect( $q123, $q345 );
+
+		$p123 = new PropertyId( 'P123' );
+		$p345 = new PropertyId( 'P345' );
+		$p123_345 = new EntityRedirect( $p123, $p345 );
+
+		return array(
+			'same' => array( $q123_345, $q123_345, true ),
+			'equal' => array( $q123_345, new EntityRedirect( $q123, $q345 ), true ),
+
+			'different base' => array( $q123_345, new EntityRedirect( $q567, $q345 ), false ),
+			'different target' => array( $q123_345, new EntityRedirect( $q123, $q567 ), false ),
+
+			'different entity type' => array( $q123_345, $p123_345, false ),
+			'different number' => array( $q123_345, new EntityRedirect( $q345, $q123 ), false ),
+
+			'null' => array( $q123_345, null, false ),
+			'string' => array( $q123_345, 'foo', false ),
+			'id' => array( $q123_345, $q123, false ),
+		);
+	}
+
+	/**
+	 * @dataProvider equalsProvider
+	 *
+	 * @param EntityRedirect $a
+	 * @param mixed $b
+	 * @param bool $expected
+	 */
+	public function testEquals( $a, $b, $expected ) {
+		$this->assertEquals( $expected, $a->equals( $b ), '$a->equals( $b )' );
+
+		if ( $b instanceof EntityRedirect ) {
+			$this->assertEquals( $expected, $b->equals( $a ), '$b->equals( $a )' );
+		}
+	}
+
+}