Add usage example

Author: jeromegamez

.gitattributes

@@ -7,4 +7,5 @@
 
 /tests export-ignore
 
+/example.php export-ignore
 /phpunit.xml.dist export-ignore

README.md

@@ -12,4 +12,57 @@ The utility can be installed with [Composer]:
 $ composer require gamez/ramsey-uuid-normalizer
 ```
 
+## Usage
+
+### Symfony Serializer Component
+
+The usage example requires the [PropertyAccess Component] component,
+which can also be installed with [Composer]:
+
+```bash
+$ composer require symfony/property-access
+```
+
+```php
+use Gamez\Symfony\Component\Serializer\Normalizer\UuidNormalizer;
+use Ramsey\Uuid\Uuid;
+use Symfony\Component\Serializer\Encoder\JsonEncoder;
+use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+use Symfony\Component\Serializer\Serializer;
+
+class Person
+{
+    public $id;
+    public $name;
+}
+
+$person = new Person();
+$person->id = Uuid::uuid4();
+$person->name = 'Jérôme Gamez';
+
+$encoders = [new JsonEncoder()];
+$normalizers = [new UuidNormalizer(), new ObjectNormalizer()];
+$serializer = new Serializer($normalizers, $encoders);
+
+$json = $serializer->serialize($person, 'json');
+echo $json.PHP_EOL;
+// {"id":"3d79048c-29e7-482f-979a-5b9a708b2ede","name":"J\u00e9r\u00f4me Gamez"}
+
+$person = $serializer->deserialize($json, Person::class, 'json');
+var_dump($person);
+/*
+class Person#27 (2) {
+  public $id =>
+  string(36) "3d79048c-29e7-482f-979a-5b9a708b2ede"
+  public $name =>
+  string(14) "Jérôme Gamez"
+}
+*/
+```
+
+For further information on how to use the Symfony Serializer Component,
+please see [The Serializer Component] in the official documentation.
+
 [Composer]: https://getcomposer.org
+[PropertyAccess Component]: https://github.com/symfony/property-access
+[The Serializer Component]: https://symfony.com/doc/current/components/serializer.html 

composer.json

@@ -15,7 +15,8 @@
         "ramsey/uuid": "^3.0"
     },
     "require-dev": {
-        "phpunit/phpunit": "^6.3"
+        "phpunit/phpunit": "^6.3",
+        "symfony/property-access": "^3.3"
     },
     "autoload": {
         "files": [

example.php

@@ -0,0 +1,31 @@
+<?php
+
+require_once __DIR__.'/vendor/autoload.php';
+
+use Gamez\Symfony\Component\Serializer\Normalizer\UuidNormalizer;
+use Ramsey\Uuid\Uuid;
+use Symfony\Component\Serializer\Encoder\JsonEncoder;
+use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+use Symfony\Component\Serializer\Serializer;
+
+class Person
+{
+    public $id;
+    public $name;
+}
+
+$person = new Person();
+$person->id = Uuid::uuid4();
+$person->name = 'Jérôme Gamez';
+
+$encoders = [new JsonEncoder()];
+$normalizers = [new UuidNormalizer(), new ObjectNormalizer()];
+$serializer = new Serializer($normalizers, $encoders);
+
+$json = $serializer->serialize($person, 'json');
+echo $json.PHP_EOL;
+
+$person = $serializer->deserialize($json, Person::class, 'json');
+var_dump($person);
+
+