Adding some documentation

Author: moufmouf

README.md

@@ -58,5 +58,20 @@ $posts = $db->table('posts')->column('title')->string(50)->graphqlField() // The
             ->failWith(null) // If the user is not logged or has no right, let's serve 'null'
             ->endGraphql();
 
+// You can pass instructions on how JSON serialization occurs.
+// This will generate a set of JSONxxx annotations.
+$nodes = $db->table('nodes')
+    ->column('id')->integer()->primaryKey()->autoIncrement()->jsonSerialize()->ignore()
+    ->column('alias_id')->references('nodes')->null()->jsonSerialize()->recursive()
+    ->column('parent_id')->references('nodes')->null()->jsonSerialize()->include()
+    ->column('root_id')->references('nodes')->null()->jsonSerialize()->ignore()
+    ->column('owner_id')->references('authors')->null()->jsonSerialize()->formatUsingProperty('name')->include()
+    ->column('owner_country')->references('authors')->null()->jsonSerialize()->formatUsingMethod('getCountryName')->include()
+    ->column('name')->string()->jsonSerialize()->key('basename')
+    ->column('size')->integer()->notNull()->default(0)->jsonSerialize()->numericFormat(null, null, null, ' o')
+    ->column('weight')->float()->null()->jsonSerialize()->numericFormat(2, ',', '.', 'g')
+    ->column('created_at')->date()->null()->jsonSerialize()->datetimeFormat("Y-m-d")
+    ->column('another_parent')->references('nodes')->comment('@JsonCollection("entries") @JsonFormat(property="entry")');
+
 $db->junctionTable('posts', 'users')->graphqlField(); // Expose the many-to-many relationship as a GraphQL field.
 ```

tests/TdbmFluidJunctionTableJsonOptionsTest.php

@@ -19,6 +19,7 @@ public function testJson()
             ->column('parent_id')->references('nodes')->null()->jsonSerialize()->include()
             ->column('root_id')->references('nodes')->null()->jsonSerialize()->ignore()
             ->column('owner_id')->references('nodes')->null()->jsonSerialize()->formatUsingProperty('name')->include()
+            ->column('owner_country')->references('nodes')->null()->jsonSerialize()->formatUsingMethod('myMethod')->include()
             ->column('name')->string()->jsonSerialize()->key('basename')
             ->column('size')->integer()->notNull()->default(0)->jsonSerialize()->numericFormat(null, null, null, ' o')
             ->column('weight')->float()->null()->jsonSerialize()->numericFormat(2, ',', '.', 'g')
@@ -31,10 +32,14 @@ public function testJson()
         $this->assertContains("@JsonInclude", $nodesTable->getColumn('parent_id')->getComment());
         $this->assertContains("@JsonIgnore", $nodesTable->getColumn('root_id')->getComment());
         $this->assertContains('@JsonFormat(property = "name")', $nodesTable->getColumn('owner_id')->getComment());
+        $this->assertContains('@JsonFormat(method = "myMethod")', $nodesTable->getColumn('owner_country')->getComment());
         $this->assertContains("@JsonKey(key = \"basename\")", $nodesTable->getColumn('name')->getComment());
         $this->assertContains("@JsonFormat(unit = \" o\")", $nodesTable->getColumn('size')->getComment());
         $this->assertContains("@JsonFormat(decimals = 2, point = \",\", separator = \".\", unit = \"g\")", $nodesTable->getColumn('weight')->getComment());
         $this->assertContains("@JsonFormat(date = \"Y-m-d\")", $nodesTable->getColumn('created_at')->getComment());
         $this->assertContains("@JsonCollection(\"entries\")", $nodesTable->getColumn('another_parent')->getComment());
+
+        $anotherColumn = $fluid->table('nodes')->column('another_column')->integer();
+        $this->assertSame($anotherColumn, $anotherColumn->jsonSerialize()->endJsonSerialize());
     }
 }