interface RouteProviderInterface in Zircon Profile 8

Interface for the route provider the DynamicRouter is using.

Typically this could be a doctrine orm or odm repository, but you can implement something else if you need to.

Hierarchy

• interface \Symfony\Cmf\Component\Routing\RouteProviderInterface

2 files declare their use of RouteProviderInterface

NestedMatcher.php in vendor/symfony-cmf/routing/NestedMatcher/NestedMatcher.php

RouteProviderInterface.php in core/lib/Drupal/Core/Routing/RouteProviderInterface.php

Contains \Drupal\Core\Routing\RouteProviderInterface.

File

vendor/symfony-cmf/routing/RouteProviderInterface.php, line 25

Namespace

Symfony\Cmf\Component\Routing

interface RouteProviderInterface {

  /**
   * Finds routes that may potentially match the request.
   *
   * This may return a mixed list of class instances, but all routes returned
   * must extend the core symfony route. The classes may also implement
   * RouteObjectInterface to link to a content document.
   *
   * This method may not throw an exception based on implementation specific
   * restrictions on the url. That case is considered a not found - returning
   * an empty array. Exceptions are only used to abort the whole request in
   * case something is seriously broken, like the storage backend being down.
   *
   * Note that implementations may not implement an optimal matching
   * algorithm, simply a reasonable first pass.  That allows for potentially
   * very large route sets to be filtered down to likely candidates, which
   * may then be filtered in memory more completely.
   *
   * @param Request $request A request against which to match.
   *
   * @return RouteCollection with all Routes that could potentially match
   *                         $request. Empty collection if nothing can match.
   */
  public function getRouteCollectionForRequest(Request $request);

  /**
   * Find the route using the provided route name.
   *
   * @param string $name The route name to fetch.
   *
   * @return Route
   *
   * @throws RouteNotFoundException If there is no route with that name in
   *                                this repository
   */
  public function getRouteByName($name);

  /**
   * Find many routes by their names using the provided list of names.
   *
   * Note that this method may not throw an exception if some of the routes
   * are not found or are not actually Route instances. It will just return the
   * list of those Route instances it found.
   *
   * This method exists in order to allow performance optimizations. The
   * simple implementation could be to just repeatedly call
   * $this->getRouteByName() while catching and ignoring eventual exceptions.
   *
   * If $names is null, this method SHOULD return a collection of all routes
   * known to this provider. If there are many routes to be expected, usage of
   * a lazy loading collection is recommended. A provider MAY only return a
   * subset of routes to e.g. support paging or other concepts, but be aware
   * that the DynamicRouter will only call this method once per
   * DynamicRouter::getRouteCollection() call.
   *
   * @param array|null $names The list of names to retrieve, In case of null,
   *                          the provider will determine what routes to return.
   *
   * @return Route[] Iterable list with the keys being the names from the
   *                     $names array.
   */
  public function getRoutesByNames($names);

}

Members

Name	Modifiers	Type	Description	Overrides
RouteProviderInterface::getRouteByName	public	function	Find the route using the provided route name.	2
RouteProviderInterface::getRouteCollectionForRequest	public	function	Finds routes that may potentially match the request.	2
RouteProviderInterface::getRoutesByNames	public	function	Find many routes by their names using the provided list of names.	2