class BookNavigationCacheContext

Same name and namespace in other branches
  1. 9 core/modules/book/src/Cache/BookNavigationCacheContext.php \Drupal\book\Cache\BookNavigationCacheContext
  2. 8.9.x core/modules/book/src/Cache/BookNavigationCacheContext.php \Drupal\book\Cache\BookNavigationCacheContext
  3. 11.x core/modules/book/src/Cache/BookNavigationCacheContext.php \Drupal\book\Cache\BookNavigationCacheContext

Defines the book navigation cache context service.

Cache context ID: 'route.book_navigation'.

This allows for book navigation location-aware caching. It depends on:

  • whether the current route represents a book node at all
  • and if so, where in the book hierarchy we are

Hierarchy

Expanded class hierarchy of BookNavigationCacheContext

1 string reference to 'BookNavigationCacheContext'
book.services.yml in core/modules/book/book.services.yml
core/modules/book/book.services.yml
1 service uses BookNavigationCacheContext
cache_context.route.book_navigation in core/modules/book/book.services.yml
Drupal\book\Cache\BookNavigationCacheContext

File

core/modules/book/src/Cache/BookNavigationCacheContext.php, line 20

Namespace

Drupal\book\Cache
View source
class BookNavigationCacheContext implements CacheContextInterface {
  
  /**
   * The current route match.
   *
   * @var \Drupal\Core\Routing\RouteMatchInterface
   */
  protected $routeMatch;
  
  /**
   * Constructs a new BookNavigationCacheContext service.
   *
   * @param \Drupal\Core\Routing\RouteMatchInterface $route_match
   *   The current route match.
   * @param \Drupal\book\BookManagerInterface|null $bookManagerService
   *   The book manager service.
   */
  public function __construct(RouteMatchInterface $route_match, public ?BookManagerInterface $bookManagerService = NULL) {
    $this->routeMatch = $route_match;
    if ($this->bookManagerService === NULL) {
      @trigger_error('Calling ' . __METHOD__ . ' without the $bookManagerService argument is deprecated in drupal:10.2.0 and it will be required in drupal:11.0.0. See https://www.drupal.org/node/3397515', E_USER_DEPRECATED);
      $this->bookManagerService = \Drupal::service('book.manager');
    }
  }
  
  /**
   * {@inheritdoc}
   */
  public static function getLabel() {
    return t("Book navigation");
  }
  
  /**
   * {@inheritdoc}
   */
  public function getContext() {
    // Find the current book's ID.
    $current_bid = 0;
    $node = $this->routeMatch
      ->getParameter('node');
    if ($node instanceof NodeInterface && !empty($node->book['bid'])) {
      $current_bid = $node->book['bid'];
    }
    // If we're not looking at a book node, then we're not navigating a book.
    if ($current_bid === 0) {
      return 'book.none';
    }
    // If we're looking at a book node, get the trail for that node.
    $active_trail = $this->bookManagerService
      ->getActiveTrailIds($node->book['bid'], $node->book);
    return implode('|', $active_trail);
  }
  
  /**
   * {@inheritdoc}
   */
  public function getCacheableMetadata() {
    // The book active trail depends on the node and data attached to it.
    // That information is however not stored as part of the node.
    $cacheable_metadata = new CacheableMetadata();
    $node = $this->routeMatch
      ->getParameter('node');
    if ($node instanceof NodeInterface) {
      // If the node is part of a book then we can use the cache tag for that
      // book. If not, then it can't be optimized away.
      if (!empty($node->book['bid'])) {
        $cacheable_metadata->addCacheTags([
          'bid:' . $node->book['bid'],
        ]);
      }
      else {
        $cacheable_metadata->setCacheMaxAge(0);
      }
    }
    return $cacheable_metadata;
  }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title
BookNavigationCacheContext::$routeMatch protected property The current route match.
BookNavigationCacheContext::getCacheableMetadata public function Gets the cacheability metadata for the context. Overrides CacheContextInterface::getCacheableMetadata
BookNavigationCacheContext::getContext public function Returns the string representation of the cache context. Overrides CacheContextInterface::getContext
BookNavigationCacheContext::getLabel public static function Returns the label of the cache context. Overrides CacheContextInterface::getLabel
BookNavigationCacheContext::__construct public function Constructs a new BookNavigationCacheContext service.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.