Update for using Handlers (by @WBerredo) and support for routing annotations (basic)

.gitignore

@@ -1,4 +1,6 @@
 /vendor/
 composer.lock
 /nbproject/private/
-nbproject/
+nbproject/
+
+.idea/

README.Symfony3.md

@@ -0,0 +1,182 @@
+# Voryx REST Generator Bundle
+[![SensioLabsInsight](https://insight.sensiolabs.com/projects/ac1842d9-4e36-45cc-8db1-b97e2e62540e/big.png)](https://insight.sensiolabs.com/projects/ac1842d9-4e36-45cc-8db1-b97e2e62540e)
+
+## About
+
+A CRUD like REST Generator
+
+## Features
+
+* Generators RESTful action from entity
+* Simplifies setting up a RESTful Controller
+
+
+## Installation
+Require the "voryx/restgeneratorbundle" package in your composer.json and update your dependencies.
+
+```bash
+$ php composer.phar require voryx/restgeneratorbundle dev-master
+```
+
+Add the VoryxRestGeneratorBundle to your application's kernel along with other dependencies:
+
+```php
+public function registerBundles()
+{
+    $bundles = array(
+        //...
+          new Voryx\RESTGeneratorBundle\VoryxRESTGeneratorBundle(),
+          new FOS\RestBundle\FOSRestBundle(),
+          new JMS\SerializerBundle\JMSSerializerBundle($this),
+          new Nelmio\CorsBundle\NelmioCorsBundle(),
+          new Nelmio\ApiDocBundle\NelmioApiDocBundle(),
+        //...
+    );
+    //...
+}
+```
+
+## Configuration
+
+This bundle depends on a number of other Symfony bundles, so they need to be configured in order for the generator to work properly
+
+```yaml
+framework:
+    csrf_protection: false #only use for public API
+
+fos_rest:
+    routing_loader:
+        default_format: json
+    param_fetcher_listener: true
+    body_listener: true
+    #disable_csrf_role: ROLE_USER
+    body_converter:
+        enabled: true
+    view:
+        view_response_listener: force
+
+nelmio_cors:
+    defaults:
+        allow_credentials: false
+        allow_origin: []
+        allow_headers: []
+        allow_methods: []
+        expose_headers: []
+        max_age: 0
+    paths:
+        '^/api/':
+            allow_origin: ['*']
+            allow_headers: ['*']
+            allow_methods: ['POST', 'PUT', 'GET', 'DELETE']
+            max_age: 3600
+
+sensio_framework_extra:
+    request: { converters: true }
+    view:    { annotations: false }
+    router:  { annotations: true }
+
+nelmio_api_doc: ~
+```
+
+## Generating the Controller
+
+
+Generate the REST controller
+
+```bash
+$ php bin/console voryx:generate:rest
+```
+
+This will guide you through the generator which will generate a RESTful controller for an entity.
+
+
+## Example
+
+Create a new entity called 'Post':
+
+```bash
+$ php bin/console doctrine:generate:entity --entity=AppBundle:Post --format=annotation --fields="name:string(255) description:string(255)" --no-interaction
+```
+
+Update the database schema:
+
+```bash
+$ php bin/console doctrine:schema:update --force
+```
+
+Generate the API controller:
+
+```bash
+$ php bin/console voryx:generate:rest --entity="AppBundle:Post"
+```
+
+Full example with all parameters
+
+```bash
+$ php app/console voryx:generate:rest --entity="AppBundle:Post" --document --overwrite --route-prefix="api" --route-format="yml" --service-format="yml" --test="none"
+```
+
+possible values for all parameters
+
+| Parameter | Explanation | Values  |
+| --------- | ----------- | ------- |
+| entity         | The entity for which the REST api should be generated            | **AppBundle:Post**, **AppBundle:Blog\Post**
+| document       | Whether or not you want API's documented by Nelmio               | Yes if present, else No
+| overwrite      | Whether or not you want to overwrite existing generated files    | Yes if present, else No
+| resource       | -                                                                | Yes if present, else No
+| route-prefix   | The route to prefix the generated Controller with (default api)  | Any string
+| route-format   | The format that routing is generated in (default yml)            | **yml** or **annotation**
+| service-format | The format that the service is generated in (default yml)        | **yml** or **xml**
+| test           | The type of test that should be generated                        | **none**, **oauth** or **no-authentication**
+
+
+### Using the API
+If you selected the default options you'll be able to start using the API like this:
+
+Creating a new post (`POST`)
+
+```bash
+$ curl -i -H "Content-Type: application/json" -X POST -d '{"name" : "Test Post", "description" : "This is a test post"}' http://localhost/app_dev.php/api/posts
+```
+
+Updating (`PUT`)
+
+```bash
+$ curl -i -H "Content-Type: application/json" -X PUT -d '{"name" : "Test Post 1", "description" : "This is an updated test post"}' http://localhost/app_dev.php/api/posts/1
+```
+
+Get all posts (`GET`)
+
+```bash
+$ curl http://localhost/app_dev.php/api/posts
+```
+
+Get one post (`GET`)
+
+```bash
+$ curl http://localhost/app_dev.php/api/posts/1
+```
+
+
+Delete (`DELETE`)
+
+```bash
+$ curl -X DELETE  http://localhost/app_dev.php/api/posts/1
+```
+
+
+## Related Entities
+
+If you want the form to be able to convert related entities into the correct entity id on POST, PUT or PATCH, use the voryx_entity form type
+
+```php
+use Voryx\RESTGeneratorBundle\Form\Type\VoryxEntityType;
+
+#Form/PostType()
+
+    ->add(
+        'user', VoryxEntityType:class, array(
+            'class' => 'Acme\Bundle\Entity\User'
+        )
+    )
+```

README.md

@@ -29,6 +29,7 @@ public function registerBundles()
           new FOS\RestBundle\FOSRestBundle(),
           new JMS\SerializerBundle\JMSSerializerBundle($this),
           new Nelmio\CorsBundle\NelmioCorsBundle(),
+          new Nelmio\ApiDocBundle\NelmioApiDocBundle(),
         //...
     );
     //...
@@ -73,6 +74,8 @@ sensio_framework_extra:
     request: { converters: true }
     view:    { annotations: false }
     router:  { annotations: true }
+
+nelmio_api_doc: ~
 ```
 
 ## Generating the Controller
@@ -107,6 +110,27 @@ Generate the API controller:
 $ php app/console voryx:generate:rest --entity="AppBundle:Post"
 ```
 
+Full example with all parameters
+
+```bash
+$ php app/console voryx:generate:rest --entity="AppBundle:Post" --document --resource --overwrite --route-prefix="api" --route-format="yml" --service-format="yml" --test="none"
+$ php app/console voryx:generate:rest --entity="AppBundle:User/Domain" --document --overwrite --route-prefix="api" --route-format="annotation" --service-format="yml" --test="oauth2"
+```
+
+possible values for all parameters
+
+| Parameter | Explanation | Values  |
+| --------- | ----------- | ------- |
+| entity         | The entity for which the REST api should be generated                 | **AppBundle:Post**, **AppBundle:Blog\Post**
+| document       | Whether or not you want API's documented by Nelmio                    | Yes if present, else No
+| overwrite      | Whether or not you want to overwrite existing generated files         | Yes if present, else No
+| resource       | Whether or not you want the resource name encapsulating the response  | Yes if present, else No
+| route-prefix   | The route to prefix the generated Controller with (default api)       | Any string
+| route-format   | The format that routing is generated in (default yml)                 | **yml** or **annotation**
+| service-format | The format that the service is generated in (default yml)             | **yml** or **xml**
+| test           | The type of test that should be generated                             | **none**, **oauth** or **no-authentication**
+
+
 ### Using the API
 If you selected the default options you'll be able to start using the API like this:
 
@@ -147,10 +171,12 @@ $ curl -X DELETE  http://localhost/app_dev.php/api/posts/1
 If you want the form to be able to convert related entities into the correct entity id on POST, PUT or PATCH, use the voryx_entity form type
 
 ```php
-#Form/PostType()
+use Voryx\RESTGeneratorBundle\Form\Type\VoryxEntityType;
+
+// ...
 
     ->add(
-        'user', 'voryx_entity', array(
+        'user', VoryxEntityType:class, array(
             'class' => 'Acme\Bundle\Entity\User'
         )
     )

composer.json

@@ -1,6 +1,6 @@
 {
     "name": "voryx/restgeneratorbundle",
-    "description": "REST API Generator for Symfony 2",
+    "description": "REST API Generator for Symfony",
     "type": "symfony-bundle",
     "license": "MIT",
     "authors": [
@@ -9,14 +9,20 @@
         },
         {
             "name": "David Dan"
+        },
+        {
+            "name": "Maarten Sprakel"
         }
     ],
     "require": {
-        "php": ">=5.3.0",
+        "php": ">=5.5.9",
+        "symfony/symfony": ">=2.8",
         "sensio/generator-bundle": "~3.0",
-        "friendsofsymfony/rest-bundle": "~1.7",
-        "jms/serializer-bundle": "~1.1",
-        "nelmio/cors-bundle": "~1.4 "
+        "friendsofsymfony/rest-bundle": "^2.2",
+        "jms/serializer-bundle": "^2.0",
+        "nelmio/cors-bundle": "~1.5",
+        "nelmio/api-doc-bundle": "~2.7",
+        "doctrine/orm": ">=2.0"
     },
     "autoload": {
         "psr-0": {