Simplification, Formatting, Performance (#83)

Author: f3ath

examples/compound_doc.php

@@ -7,8 +7,9 @@
 use JsonApiPhp\JsonApi\Link\NextLink;
 use JsonApiPhp\JsonApi\Link\RelatedLink;
 use JsonApiPhp\JsonApi\Link\SelfLink;
-use JsonApiPhp\JsonApi\PaginatedResourceCollection;
+use JsonApiPhp\JsonApi\PaginatedCollection;
 use JsonApiPhp\JsonApi\Pagination;
+use JsonApiPhp\JsonApi\ResourceCollection;
 use JsonApiPhp\JsonApi\ResourceIdentifier;
 use JsonApiPhp\JsonApi\ResourceIdentifierCollection;
 use JsonApiPhp\JsonApi\ResourceObject;
@@ -39,34 +40,36 @@
     '12',
     new Attribute('body', 'I like XML better'),
     new SelfLink('http://example.com/comments/12'),
-    new ToOne('author', $dan->toIdentifier())
+    new ToOne('author', $dan->identifier())
 );
 
 $document = new CompoundDocument(
-    new PaginatedResourceCollection(
+    new PaginatedCollection(
         new Pagination(
             new NextLink('http://example.com/articles?page[offset]=2'),
             new LastLink('http://example.com/articles?page[offset]=10')
         ),
-        new ResourceObject(
-            'articles',
-            '1',
-            new Attribute('title', 'JSON API paints my bikeshed!'),
-            new SelfLink('http://example.com/articles/1'),
-            new ToOne(
-                'author',
-                $dan->toIdentifier(),
-                new SelfLink('http://example.com/articles/1/relationships/author'),
-                new RelatedLink('http://example.com/articles/1/author')
-            ),
-            new ToMany(
-                'comments',
-                new ResourceIdentifierCollection(
-                    $comment05->toIdentifier(),
-                    $comment12->toIdentifier()
+        new ResourceCollection(
+            new ResourceObject(
+                'articles',
+                '1',
+                new Attribute('title', 'JSON API paints my bikeshed!'),
+                new SelfLink('http://example.com/articles/1'),
+                new ToOne(
+                    'author',
+                    $dan->identifier(),
+                    new SelfLink('http://example.com/articles/1/relationships/author'),
+                    new RelatedLink('http://example.com/articles/1/author')
                 ),
-                new SelfLink('http://example.com/articles/1/relationships/comments'),
-                new RelatedLink('http://example.com/articles/1/comments')
+                new ToMany(
+                    'comments',
+                    new ResourceIdentifierCollection(
+                        $comment05->identifier(),
+                        $comment12->identifier()
+                    ),
+                    new SelfLink('http://example.com/articles/1/relationships/comments'),
+                    new RelatedLink('http://example.com/articles/1/comments')
+                )
             )
         )
     ),

src/Attribute.php

@@ -5,6 +5,9 @@
 use JsonApiPhp\JsonApi\Internal\ResourceField;
 use JsonApiPhp\JsonApi\Internal\ResourceFieldTrait;
 
+/**
+ * @see http://jsonapi.org/format/#document-resource-object-attributes
+ */
 final class Attribute implements ResourceField
 {
     use ResourceFieldTrait;
@@ -17,7 +20,7 @@ public function __construct(string $name, $val)
         $this->val = $val;
     }
 
-    public function attachTo(object $o)
+    public function attachTo(object $o): void
     {
         child($o, 'attributes')->{$this->name} = $this->val;
     }

src/CompoundDocument.php

@@ -5,6 +5,10 @@
 use JsonApiPhp\JsonApi\Internal\DataDocumentMember;
 use JsonApiPhp\JsonApi\Internal\PrimaryData;
 
+/**
+ * A Document with the "included" member
+ * @see http://jsonapi.org/format/#document-compound-documents
+ */
 final class CompoundDocument implements \JsonSerializable
 {
     private $doc;

src/DataDocument.php

@@ -5,6 +5,10 @@
 use JsonApiPhp\JsonApi\Internal\DataDocumentMember;
 use JsonApiPhp\JsonApi\Internal\PrimaryData;
 
+/**
+ * A Document containing the "data" member
+ * @see http://jsonapi.org/format/#document-top-level
+ */
 final class DataDocument implements \JsonSerializable
 {
     private $value;

src/Error.php

@@ -5,6 +5,10 @@
 use JsonApiPhp\JsonApi\Internal\ErrorDocumentMember;
 use JsonApiPhp\JsonApi\Internal\ErrorMember;
 
+/**
+ * An Error Object
+ * @see
+ */
 final class Error implements ErrorDocumentMember
 {
     private $error;
@@ -17,7 +21,7 @@ public function __construct(ErrorMember ...$members)
         }
     }
 
-    public function attachTo(object $o)
+    public function attachTo(object $o): void
     {
         $o->errors[] = $this->error;
     }

src/ErrorDocument.php

@@ -4,21 +4,25 @@
 
 use JsonApiPhp\JsonApi\Internal\ErrorDocumentMember;
 
+/**
+ * A Document containing an array of Error objects
+ * @see http://jsonapi.org/format/#document-top-level
+ */
 final class ErrorDocument implements \JsonSerializable
 {
-    private $doc;
+    private $obj;
 
     public function __construct(Error $error, ErrorDocumentMember ...$members)
     {
-        $this->doc = (object) [];
-        $error->attachTo($this->doc);
+        $this->obj = (object) [];
+        $error->attachTo($this->obj);
         foreach ($members as $member) {
-            $member->attachTo($this->doc);
+            $member->attachTo($this->obj);
         }
     }
 
     public function jsonSerialize()
     {
-        return $this->doc;
+        return $this->obj;
     }
 }

src/Included.php

@@ -3,7 +3,6 @@
 namespace JsonApiPhp\JsonApi;
 
 use JsonApiPhp\JsonApi\Internal\Attachable;
-use JsonApiPhp\JsonApi\Internal\IdentifierRegistry;
 use JsonApiPhp\JsonApi\Internal\PrimaryData;
 
 final class Included implements Attachable
@@ -13,34 +12,33 @@ final class Included implements Attachable
      */
     private $resources = [];
 
-    private $ids;
+    private $identifiers = [];
 
     public function __construct(ResourceObject ...$resources)
     {
-        $this->ids = new IdentifierRegistry();
         foreach ($resources as $resource) {
-            $string_id = $resource->key();
-            if (isset($this->resources[$string_id])) {
-                throw new \LogicException("Resource $string_id is already included");
+            $key = $resource->key();
+            if (isset($this->resources[$key])) {
+                throw new \LogicException("Resource $resource is already included");
             }
-            $this->resources[$string_id] = $resource;
-            $resource->registerIn($this->ids);
+            $this->resources[$key] = $resource;
+            $resource->registerIn($this->identifiers);
         }
     }
 
     public function validateLinkage(PrimaryData $data): void
     {
-        $dataRegistry = new IdentifierRegistry();
-        $data->registerIn($dataRegistry);
+        $registry = [];
+        $data->registerIn($registry);
         foreach ($this->resources as $resource) {
-            if ($dataRegistry->has($resource->key()) || $this->ids->has($resource->key())) {
+            if (isset($registry[$resource->key()]) || isset($this->identifiers[$resource->key()])) {
                 continue;
             }
-            throw new \LogicException('Full linkage required for '.$resource->key());
+            throw new \LogicException('Full linkage required for '.$resource);
         }
     }
 
-    public function attachTo(object $o)
+    public function attachTo(object $o): void
     {
         foreach ($this->resources as $resource) {
             $resource->attachAsIncludedTo($o);

src/Internal/Attachable.php

@@ -7,5 +7,5 @@
  */
 interface Attachable
 {
-    public function attachTo(object $o);
+    public function attachTo(object $o): void;
 }

src/Internal/Collection.php

@@ -0,0 +1,7 @@
+<?php declare(strict_types=1);
+
+namespace JsonApiPhp\JsonApi\Internal;
+
+interface Collection extends PrimaryData
+{
+}

src/Internal/Identifier.php

@@ -7,5 +7,9 @@
  */
 interface Identifier
 {
-    public function registerIn(IdentifierRegistry $registry);
+    /**
+     * @internal
+     * @param array $registry
+     */
+    public function registerIn(array &$registry): void;
 }