add a way to filter areas on route by annotation

[babaorum]

Fix #1246

Description

A new boolean configuration is available in the areas: with_annotation.
By setting it to true, every route will be filtered by annotation.
Every route to match will need to add the @Areas with the area name.

Example

the default area would only match the testAction(), while the area2 will match both.

areas:
    default:
        path_patterns:
            - '^/api/'
        with_annotation: true
    area2:
        with_annotation: true

class ApiController
{
    /**
     * @Areas({'default', 'area2'})
     */
    public function testAction()
    {
    }

    /**
     * @Areas({'area2'})
     */
    public function test2Action()
    {
    }
}

[GuilhemN]

That's great, thanks!
I left a few comments :)

[GuilhemN]

was?

[GuilhemN]

I don't think this is a worth an util class, could we inline it please ?

[GuilhemN]

annotation_reader instead, caching is managed by symfony

[babaorum]

I fixed everything according to your comments.
Let me know if you see anything else.

[GuilhemN]

Thank you @babaorum!

[ikleiman]

Thanks @babaorum

Worked like a charm, but had to use it with double quotes instead of single ones (as explained in https://stackoverflow.com/questions/6338178/troubleshooting-syntax-error-expected-plainvalue-got):

    /**
     * @Areas({"area2"})
     */
    public function test2Action()
    {
    }