class ChainMatcher

ChainMatcherTest.php in drupal/core/modules/system/lib/Drupal/system/Tests/Routing/ChainMatcherTest.php

Definition of Drupal\system\Tests\Routing\ChainMatcherTest.

class ChainMatcher implements RequestMatcherInterface, RequestContextAwareInterface {

  /**
   * Array of RequestMatcherInterface objects to be checked in order.
   *
   * @var array
   */
  protected $matchers = array();

  /**
   * Array of RequestMatcherInterface objects, sorted.
   *
   * @var type
   */
  protected $sortedMatchers = array();

  /**
   * The request context for this matcher.
   *
   * This is unused.  It's just to satisfy the interface.
   *
   * @var Symfony\Component\Routing\RequestContext
   */
  protected $context;

  /**
   * Constructor.
   */
  public function __construct() {

    // We will not actually use this object, but it's needed to conform to
    // the interface.
    $this->context = new RequestContext();
  }

  /**
   * Sets the request context.
   *
   * This method is just to satisfy the interface, and is largely vestigial.
   * The request context object does not contain the information we need, so
   * we will use the original request object.
   *
   * @param Symfony\Component\Routing\RequestContext $context
   *   The context.
   */
  public function setContext(RequestContext $context) {
    $this->context = $context;
  }

  /**
   * Gets the request context.
   *
   * This method is just to satisfy the interface, and is largely vestigial.
   * The request context object does not contain the information we need, so
   * we will use the original request object.
   *
   * @return Symfony\Component\Routing\RequestContext
   *   The context.
   */
  public function getContext() {
    return $this->context;
  }

  /**
   * Matches a request against all queued matchers.
   *
   * @param Request $request The request to match
   *
   * @return array An array of parameters
   *
   * @throws \Symfony\Component\Routing\Exception\ResourceNotFoundException
   *   If no matching resource could be found
   * @throws \Symfony\Component\Routing\Exception\MethodNotAllowedException
   *   If a matching resource was found but the request method is not allowed
   */
  public function matchRequest(Request $request) {
    $methodNotAllowed = null;
    foreach ($this
      ->all() as $matcher) {
      try {
        return $matcher
          ->matchRequest($request);
      } catch (ResourceNotFoundException $e) {

        // Needs special care
      } catch (MethodNotAllowedException $e) {
        $methodNotAllowed = $e;
      }
    }
    throw $methodNotAllowed ?: new ResourceNotFoundException("None of the matchers in the chain matched this request.");
  }

  /**
   * Adds a Matcher to the index.
   *
   * @param MatcherInterface $matcher
   *   The matcher to add.
   * @param int $priority
   *   (optional) The priority of the matcher. Higher number matchers will be checked
   *   first. Default to 0.
   */
  public function add(RequestMatcherInterface $matcher, $priority = 0) {
    if (empty($this->matchers[$priority])) {
      $this->matchers[$priority] = array();
    }
    $this->matchers[$priority][] = $matcher;
    $this->sortedMatchers = array();
  }

  /**
   * Sorts the matchers and flattens them.
   *
   * @return array
   *   An array of RequestMatcherInterface objects.
   */
  public function all() {
    if (empty($this->sortedMatchers)) {
      $this->sortedMatchers = $this
        ->sortMatchers();
    }
    return $this->sortedMatchers;
  }

  /**
   * Sort matchers by priority.
   *
   * The highest priority number is the highest priority (reverse sorting).
   *
   * @return \Symfony\Component\Routing\RequestMatcherInterface[]
   *   An array of Matcher objects in the order they should be used.
   */
  protected function sortMatchers() {
    $sortedMatchers = array();
    krsort($this->matchers);
    foreach ($this->matchers as $matchers) {
      $sortedMatchers = array_merge($sortedMatchers, $matchers);
    }
    return $sortedMatchers;
  }

}