Update attribute representation to latest spec

Author: neomerx

README.md

@@ -56,8 +56,10 @@ will output
     "data": {
         "type": "people",
         "id": "123",
-        "first_name": "John",
-        "last_name": "Dow",
+        "attributes": {
+            "first_name": "John",
+            "last_name": "Dow"
+        },
         "links": {
             "self": "http:\/\/example.com\/people\/123"
         }
@@ -110,7 +112,9 @@ will output
     "data": {
         "type": "sites",
         "id": "1",
-        "name": "JSON API Samples",
+        "attributes": {
+            "name": "JSON API Samples"
+        },
         "links": {
             "self": "http:\/\/example.com\/sites\/1",
             "posts": {
@@ -125,13 +129,17 @@ will output
         {
             "type": "people",
             "id": "123",
-            "first_name": "John",
-            "last_name": "Dow"
+            "attributes": {
+                "first_name": "John",
+                "last_name": "Dow"
+            }
         },
         {
             "type": "comments",
             "id": "456",
-            "body": "Included objects work as easy as basic ones",
+            "attributes": {
+                "body": "Included objects work as easy as basic ones"
+            },
             "links": {
                 "self": "http:\/\/example.com\/comments\/456",
                 "author": {
@@ -145,7 +153,9 @@ will output
         {
             "type": "comments",
             "id": "789",
-            "body": "Let's try!",
+            "attributes": {
+                "body": "Let's try!"
+            },
             "links": {
                 "self": "http:\/\/example.com\/comments\/789",
                 "author": {
@@ -159,8 +169,10 @@ will output
         {
             "type": "posts",
             "id": "321",
-            "title": "Included objects",
-            "body": "Yes, it is supported",
+            "attributes": {
+                "title": "Included objects",
+                "body": "Yes, it is supported"
+            },
             "links": {
                 "author": {
                     "linkage": {
@@ -216,22 +228,20 @@ Note that output does not contain objects from neither ```posts``` nor ```posts.
     "data": {
         "type": "sites",
         "id": "1",
-        "name": "JSON API Samples",
+        "attributes": {
+            "name": "JSON API Samples"
+        },
         "links": {
-            "self": "http:\/\/example.com\/sites\/1",
-            "posts": {
-                "linkage": {
-                    "type": "posts",
-                    "id": "321"
-                }
-            }
+            "self": "http:\/\/example.com\/sites\/1"
         }
     },
     "included": [
         {
             "type": "people",
             "id": "123",
-            "first_name": "John"
+            "attributes": {
+                "first_name": "John"
+            }
         }
     ]
 }
@@ -342,6 +352,68 @@ class YourSchema extends SchemaProvider
 }
 ```
 
+### Show top level links and meta information
+
+```php
+$author = Author::instance('123', 'John', 'Dow');
+$meta   = [
+    "copyright" => "Copyright 2015 Example Corp.",
+    "authors"   => [
+        "Yehuda Katz",
+        "Steve Klabnik",
+        "Dan Gebhardt"
+    ]
+];
+$links  = new DocumentLinks(
+    null,
+    'http://example.com/people?first',
+    'http://example.com/people?last',
+    'http://example.com/people?prev',
+    'http://example.com/people?next'
+);
+
+$encoder  = Encoder::instance([
+    Author::class  => AuthorSchema::class,
+    Comment::class => CommentSchema::class,
+    Post::class    => PostSchema::class,
+    Site::class    => SiteSchema::class
+], new JsonEncodeOptions(JSON_PRETTY_PRINT));
+
+echo $encoder->encode($author, $links, $meta) . PHP_EOL;
+```
+
+will output
+
+```json
+{
+    "meta": {
+        "copyright": "Copyright 2015 Example Corp.",
+        "authors": [
+            "Yehuda Katz",
+            "Steve Klabnik",
+            "Dan Gebhardt"
+        ]
+    },
+    "links": {
+        "first": "http:\/\/example.com\/people?first",
+        "last": "http:\/\/example.com\/people?last",
+        "prev": "http:\/\/example.com\/people?prev",
+        "next": "http:\/\/example.com\/people?next"
+    },
+    "data": {
+        "type": "people",
+        "id": "123",
+        "attributes": {
+            "first_name": "John",
+            "last_name": "Dow"
+        },
+        "links": {
+            "self": "http:\/\/example.com\/people\/123"
+        }
+    }
+}
+```
+
 ## Questions?
 
 Do not hesitate to contact us on [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/neomerx/json-api) or post an [issue](https://github.com/neomerx/json-api/issues).

sample/README.md

@@ -17,8 +17,10 @@ will output
     "data": {
         "type": "people",
         "id": "123",
-        "first_name": "John",
-        "last_name": "Dow",
+        "attributes": {
+            "first_name": "John",
+            "last_name": "Dow"
+        },
         "links": {
             "self": "http:\/\/example.com\/people\/123"
         }

sample/composer.json

@@ -16,6 +16,6 @@
     },
     "minimum-stability": "dev",
     "require": {
-        "neomerx/json-api": "0.1"
+        "neomerx/json-api": "0.1.1"
     }
 }

sample/sample.php

@@ -102,6 +102,40 @@ private function showSparseAndFieldSetsExample()
         echo $encoder->encode($site, null, null, $options) . PHP_EOL;
     }
 
+    /**
+     * Shows sparse and field set filters.
+     */
+    private function showTopLevelMetaAndLinksExample()
+    {
+        echo 'Neomerx JSON API sample application (top level links and meta information)' . PHP_EOL;
+
+        $author = Author::instance('123', 'John', 'Dow');
+        $meta   = [
+            "copyright" => "Copyright 2015 Example Corp.",
+            "authors"   => [
+                "Yehuda Katz",
+                "Steve Klabnik",
+                "Dan Gebhardt"
+            ]
+        ];
+        $links  = new DocumentLinks(
+            null,
+            'http://example.com/people?first',
+            'http://example.com/people?last',
+            'http://example.com/people?prev',
+            'http://example.com/people?next'
+        );
+
+        $encoder  = Encoder::instance([
+            Author::class  => AuthorSchema::class,
+            Comment::class => CommentSchema::class,
+            Post::class    => PostSchema::class,
+            Site::class    => SiteSchema::class
+        ], new JsonEncodeOptions(JSON_PRETTY_PRINT));
+
+        echo $encoder->encode($author, $links, $meta) . PHP_EOL;
+    }
+
     /**
      * Run performance test.
      *
@@ -151,6 +185,7 @@ public function main()
             $this->showBasicExample();
             $this->showIncludedObjectsExample();
             $this->showSparseAndFieldSetsExample();
+            $this->showTopLevelMetaAndLinksExample();
         } else {
             $num = $args['t'];
             $inv = empty($num) === true || is_numeric($num) === false || ctype_digit($num) == false || (int)$num <= 0;