[Routing] Cleanups in Router class

Mainly PHPDocs and fixing return statements in several methods for consistency. Also removed dead code in getResourceAction method.