class ContextualController in Drupal 8

Returns responses for Contextual module routes.

Hierarchy

• class \Drupal\contextual\ContextualController implements ContainerInjectionInterface

File

core/modules/contextual/src/ContextualController.php, line 17

Namespace

Drupal\contextual

class ContextualController implements ContainerInjectionInterface {

  /**
   * The renderer.
   *
   * @var \Drupal\Core\Render\RendererInterface
   */
  protected $renderer;

  /**
   * Constructors a new ContextualController.
   *
   * @param \Drupal\Core\Render\RendererInterface $renderer
   *   The renderer.
   */
  public function __construct(RendererInterface $renderer) {
    $this->renderer = $renderer;
  }

  /**
   * {@inheritdoc}
   */
  public static function create(ContainerInterface $container) {
    return new static($container
      ->get('renderer'));
  }

  /**
   * Returns the requested rendered contextual links.
   *
   * Given a list of contextual links IDs, render them. Hence this must be
   * robust to handle arbitrary input.
   *
   * @param \Symfony\Component\HttpFoundation\Request $request
   *   The Symfony request object.
   *
   * @return \Symfony\Component\HttpFoundation\JsonResponse
   *   The JSON response.
   *
   * @throws \Symfony\Component\HttpKernel\Exception\BadRequestHttpException
   *   Thrown when the request contains no ids.
   *
   * @see contextual_preprocess()
   */
  public function render(Request $request) {
    $ids = $request->request
      ->get('ids');
    if (!isset($ids)) {
      throw new BadRequestHttpException('No contextual ids specified.');
    }
    $tokens = $request->request
      ->get('tokens');
    if (!isset($tokens)) {
      throw new BadRequestHttpException('No contextual ID tokens specified.');
    }
    $rendered = [];
    foreach ($ids as $key => $id) {
      if (!isset($tokens[$key]) || !hash_equals($tokens[$key], Crypt::hmacBase64($id, Settings::getHashSalt() . \Drupal::service('private_key')
        ->get()))) {
        throw new BadRequestHttpException('Invalid contextual ID specified.');
      }
      $element = [
        '#type' => 'contextual_links',
        '#contextual_links' => _contextual_id_to_links($id),
      ];
      $rendered[$id] = $this->renderer
        ->renderRoot($element);
    }
    return new JsonResponse($rendered);
  }

}

Members

Name	Modifiers	Type	Description	Overrides
ContextualController::$renderer	protected	property	The renderer.
ContextualController::create	public static	function	Instantiates a new instance of this class. Overrides ContainerInjectionInterface::create
ContextualController::render	public	function	Returns the requested rendered contextual links.
ContextualController::__construct	public	function	Constructors a new ContextualController.