VersatileGeneratorInterface.php

<?php

namespace Symfony\Cmf\Component\Routing;

use Symfony\Component\Routing\Generator\UrlGeneratorInterface;

/**
 * This generator is able to handle more than string route names as symfony
 * core supports them.
 */
interface VersatileGeneratorInterface extends UrlGeneratorInterface {

  /**
   * Whether this generator supports the supplied $name.
   *
   * This check does not need to look if the specific instance can be
   * resolved to a route, only whether the router can generate routes from
   * objects of this class.
   *
   * @param mixed $name The route "name" which may also be an object or anything
   *
   * @return bool
   */
  public function supports($name);

  /**
   * Convert a route identifier (name, content object etc) into a string
   * usable for logging and other debug/error messages
   *
   * @param mixed $name
   * @param array $parameters which should contain a content field containing
   *                          a RouteAwareInterface object
   *
   * @return string
   */
  public function getRouteDebugMessage($name, array $parameters = array());

}