Improve router

[johanjanssens]

At the moment page, redirect and file routing works independently through different event subscribers. Refactor the implementation to route through the http dispatcher.

• Allow to attach different routers (similar to attaching resolvers)
• If no specific route passed iterate through each router to resolve the request
• Add a file controller and implement a download action to handle file downloads
• Allow setting different cache settings per router (page, file, redirect)
• Make qualify() method signature match generate() and resolve()
• Add magic getter and get() method to route object
• Filter the url query variables using the url filter before injecting them into the route (security)

Notes:

• Refactor ComPagesDispatcherRouterAbstract::getRoute() to createRoute() and make getRoute() return the last generated route for the specific router.

• Allow for getRoute('site') and getRoute('page') to get a route from a specific router.

• Set a default router fallback in ComPagesDispatcherRouter in case a specific router is not specified.

• Implement router routing in ComPagesDispatcherRouter in a similar way to resolver router, using a double linked list.

• Allow to return route query variables through magic getter and provide a get() method. => Remove support for magic 'path' and 'query' from the route. See: Add route constraint for language codes #391

Related:

• https://nextjs.org/docs/routing/dynamic-routes

[johanjanssens]

Thoughts; refactor singleton router to a router factory, dispatcher router would use the factory to create the correct router, which means it no longer needs to be a singleton.