Introduce MismatchingDataValueTypeException

composer.json

@@ -25,7 +25,7 @@
 	"require": {
 		"php": ">=5.3.0",
 		"data-values/data-values": "~0.1",
-		"data-values/interfaces": "~0.1.2"
+		"data-values/interfaces": "~0.1.3"
 	},
 	"extra": {
 		"branch-alias": {

src/ValueFormatters/Exceptions/DataValueTypeMismatchException.php

@@ -0,0 +1,57 @@
+<?php
+
+namespace ValueFormatters\Exceptions;
+
+use ValueFormatters\FormattingException;
+
+/**
+ * @since 0.2.1
+ *
+ * @licence GNU GPL v2+
+ * @author Katie Filbert < aude.wiki@gmail.com >
+ */
+class DataValueTypeMismatchException extends FormattingException {
+
+	/**
+	 * @var string
+	 */
+	protected $expectedValueType;
+
+	/**
+	 * @var string
+	 */
+	protected $dataValueType;
+
+	/**
+	 * @param string $expectedValueType
+	 * @param string $dataValueType
+	 * @param string $message
+	 * @param \Exception $previous
+	 */
+	public function __construct( $expectedValueType, $dataValueType, $message = '',
+		\Exception $previous = null
+	) {
+		$this->expectedValueType = $expectedValueType;
+		$this->dataValueType = $dataValueType;
+
+		$message = "DataValueType $dataValueType does not match expected value "
+			. "type $expectedValueType: " . $message;
+
+		parent::__construct( $message, 0, $previous );
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getExpectedValueType() {
+		return $this->expectedValueType;
+	}
+
+	/**
+	 * @return string
+	 */
+	public function getDataValueType() {
+		return $this->dataValueType;
+	}
+
+}

tests/ValueFormatters/Exceptions/DataValueTypeMismatchExceptionTest.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace ValueFormatters\Tests\Exceptions;
+
+use ValueFormatters\Exceptions\DataValueTypeMismatchException;
+
+/**
+ * @covers ValueFormatters\Exceptions\DataValueTypeMismatchException
+ *
+ * @group ValueFormatters
+ * @group DataValueExtensions
+ *
+ * @licence GNU GPL v2+
+ * @author Katie Filbert < aude.wiki@gmail.com >
+ */
+class DataValueTypeMismatchExceptionTest extends \PHPUnit_Framework_TestCase {
+
+	/**
+	 * @dataProvider constructorProvider
+	 */
+	public function testConstructorWithRequiredArguments( $expectedType, $actualType ) {
+		$exception = new DataValueTypeMismatchException( $expectedType, $actualType );
+
+		$this->assertEquals( $actualType, $exception->getDataValueType() );
+		$this->assertEquals( $expectedType, $exception->getExpectedValueType() );
+	}
+
+	/**
+	 * @dataProvider constructorProvider
+	 */
+	public function testConstructorWithAllArguments( $expectedType, $actualType ) {
+		$message = 'Onoez! an error!';
+		$previous = new \Exception( 'Onoez!' );
+
+		$exception = new DataValueTypeMismatchException(
+			$expectedType,
+			$actualType,
+			$message,
+			$previous
+		);
+
+		$this->assertEquals( $actualType, $exception->getDataValueType() );
+		$this->assertEquals( $expectedType, $exception->getExpectedValueType() );
+		$this->assertContains( $message, $exception->getMessage() );
+		$this->assertEquals( $previous, $exception->getPrevious() );
+	}
+
+	public function constructorProvider() {
+		return array(
+			array( 'string', 'time' ),
+			array( 'globecoordinate', 'string' )
+		);
+	}
+
+}