Split IArray into IStruct and ITable in order to be able to differentiate them later.

Author: gregor-j

src/Api/IApi.php

@@ -38,7 +38,7 @@ public function getOutputValues();
 
     /**
      * Get all tables of the remote function.
-     * @return \phpsap\interfaces\Api\IArray[]
+     * @return \phpsap\interfaces\Api\ITable[]
      */
     public function getTables();
 }

src/Api/IArray.php

@@ -5,37 +5,27 @@
 /**
  * Interface IArray
  *
- * API extend the logic of values but contain member elements.
+ * API extend the logic of values to contain member elements.
  *
  * @package phpsap\interfaces\Api
  * @author  Gregor J.
  * @license MIT
  */
 interface IArray extends IValue
 {
-    /**
-     * API table element.
-     */
-    const DIRECTION_TABLE = 'table';
-
-    /**
-     * API element that casts to PHP array.
-     */
-    const TYPE_ARRAY = 'array';
-
     /**
      * JSON configuration key for members array.
      */
     const JSON_MEMBERS = 'members';
 
     /**
      * Cast a given output value to the implemented value.
-     * @param array $struct The output array to typecast.
+     * @param array $value The output array to typecast.
      * @return array
      * @throws \phpsap\interfaces\exceptions\IArrayElementMissingException
      * @throws \phpsap\interfaces\exceptions\IInvalidArgumentException
      */
-    public function cast($struct);
+    public function cast($value);
 
     /**
      * Return an array of member elements.

src/Api/IElement.php

@@ -87,7 +87,7 @@ public function getName();
     /**
      * Cast a given output value to the implemented value.
      * @param bool|int|float|string $value The output to typecast.
-     * @return bool|int|float|string|\phpsap\DateTime\SapDateTime
+     * @return bool|int|float|string|\phpsap\DateTime\SapDateTime|\phpsap\DateTime\SapDateInterval
      * @throws \phpsap\interfaces\exceptions\IInvalidArgumentException
      */
     public function cast($value);

src/Api/IStruct.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace phpsap\interfaces\Api;
+
+/**
+ * Interface IStruct
+ *
+ * API extend the logic of arrays to contain member elements.
+ *
+ * @package phpsap\interfaces\Api
+ * @author  Gregor J.
+ * @license MIT
+ */
+interface IStruct extends IArray
+{
+    /**
+     * API element that casts to an associative array in PHP.
+     */
+    const TYPE_STRUCT = 'struct';
+}

src/Api/ITable.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace phpsap\interfaces\Api;
+
+/**
+ * Interface ITable
+ *
+ * API extend the logic of arrays but contains rows of member elements.
+ *
+ * @package phpsap\interfaces\Api
+ * @author  Gregor J.
+ * @license MIT
+ */
+interface ITable extends IArray
+{
+    /**
+     * API table element.
+     */
+    const DIRECTION_TABLE = 'table';
+
+    /**
+     * API element that casts to a PHP array of associative arrays.
+     */
+    const TYPE_TABLE = 'table';
+}

src/exceptions/IArrayElementMissingException.php

@@ -5,7 +5,7 @@
 /**
  * Interface IArrayElementMissingException
  *
- * A table element required by the API is not in the table.
+ * A table/struct element required by the API is not in the table/struct.
  *
  * @package phpsap\interfaces\exceptions
  * @author  Gregor J.