allow to deserialize a JSON encoded collection of statements

Author: xabbuh

Serializer/StatementSerializer.php

@@ -58,4 +58,16 @@ public function deserializeStatement($data)
             'json'
         );
     }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function deserializeStatements($data)
+    {
+        return $this->serializer->deserialize(
+            $data,
+            'array<Xabbuh\XApi\Storage\MongoDB\Document\Statement>',
+            'json'
+        );
+    }
 }

Serializer/StatementSerializerInterface.php

@@ -46,4 +46,13 @@ public function serializeStatements(array $statements);
      * @return StatementInterface The parsed statement
      */
     public function deserializeStatement($data);
+
+    /**
+     * Parses a serialized collection of statements.
+     *
+     * @param string $data The serialized statements
+     *
+     * @return StatementInterface[] The parsed statements
+     */
+    public function deserializeStatements($data);
 }

Tests/Model/fixtures/statement_collection.json

@@ -0,0 +1,36 @@
+[
+    {
+        "id": "12345678-1234-5678-8234-567812345678",
+        "actor": {
+            "mbox": "mailto:[email protected]",
+            "objectType": "Agent"
+        },
+        "verb": {
+            "id": "http://adlnet.gov/expapi/verbs/created",
+            "display": {
+                "en-US": "created"
+            }
+        },
+        "object": {
+            "id": "http://example.adlnet.gov/xapi/example/activity",
+            "objectType": "Activity"
+        }
+    },
+    {
+        "id": "12345678-1234-5678-8234-567812345679",
+        "actor": {
+            "mbox": "mailto:[email protected]",
+            "objectType": "Agent"
+        },
+        "verb": {
+            "id": "http://adlnet.gov/expapi/verbs/created",
+            "display": {
+                "en-US": "created"
+            }
+        },
+        "object": {
+            "id": "http://example.adlnet.gov/xapi/example/activity",
+            "objectType": "Activity"
+        }
+    }
+]

Tests/Serializer/StatementSerializerTest.php

@@ -154,6 +154,25 @@ public function testDeserializeWithResult()
         $this->assertTrue($result->getCompletion());
     }
 
+    public function testDeserializeStatementCollection()
+    {
+        /** @var \Xabbuh\XApi\Common\Model\Statement[] $statements */
+        $statements = $this->statementSerializer->deserializeStatements(
+            $this->loadFixture('statement_collection')
+        );
+
+        $this->assertTrue(is_array($statements));
+        $this->assertCount(2, $statements);
+        $this->assertEquals(
+            '12345678-1234-5678-8234-567812345678',
+            $statements[0]->getId()
+        );
+        $this->assertEquals(
+            '12345678-1234-5678-8234-567812345679',
+            $statements[1]->getId()
+        );
+    }
+
     public function testSerializeMinimalStatement()
     {
         $statement = new Statement();