class Context

Same name in this branch
  1. 11.x core/lib/Drupal/Component/Plugin/Context/Context.php \Drupal\Component\Plugin\Context\Context
Same name and namespace in other branches
  1. 9 core/lib/Drupal/Core/Plugin/Context/Context.php \Drupal\Core\Plugin\Context\Context
  2. 9 core/lib/Drupal/Component/Plugin/Context/Context.php \Drupal\Component\Plugin\Context\Context
  3. 8.9.x core/lib/Drupal/Core/Plugin/Context/Context.php \Drupal\Core\Plugin\Context\Context
  4. 8.9.x core/lib/Drupal/Component/Plugin/Context/Context.php \Drupal\Component\Plugin\Context\Context
  5. 10 core/lib/Drupal/Core/Plugin/Context/Context.php \Drupal\Core\Plugin\Context\Context
  6. 10 core/lib/Drupal/Component/Plugin/Context/Context.php \Drupal\Component\Plugin\Context\Context

A Drupal specific context wrapper class.

Hierarchy

  • class \Drupal\Core\Plugin\Context\Context extends \Drupal\Core\Plugin\Context\ContextInterface uses \Drupal\Core\TypedData\TypedDataTrait, \Drupal\Core\DependencyInjection\DependencySerializationTrait implements \Drupal\Component\Plugin\Context\Context

Expanded class hierarchy of Context

29 files declare their use of Context
AddNavigationBlock.php in core/modules/navigation/src/Plugin/ConfigAction/AddNavigationBlock.php
AddNavigationBlockConfigActionTest.php in core/modules/navigation/tests/src/Kernel/ConfigAction/AddNavigationBlockConfigActionTest.php
ContextAwarePluginTrait.php in core/lib/Drupal/Core/Plugin/ContextAwarePluginTrait.php
ContextDefinitionIsSatisfiedTest.php in core/tests/Drupal/Tests/Core/Plugin/Context/ContextDefinitionIsSatisfiedTest.php
ContextDefinitionTest.php in core/tests/Drupal/KernelTests/Core/Plugin/ContextDefinitionTest.php

... See full list

23 string references to 'Context'
ContextualLinkDefaultTest::testGetTitleWithContext in core/tests/Drupal/Tests/Core/Menu/ContextualLinkDefaultTest.php
@covers ::getTitle[[api-linebreak]]
drupal7.php in core/modules/forum/tests/fixtures/drupal7.php
A database agnostic dump for testing purposes.
drupal7.php in core/modules/statistics/tests/fixtures/drupal7.php
A database agnostic dump for testing purposes.
drupal7.php in core/modules/migrate_drupal/tests/fixtures/drupal7.php
A database agnostic dump for testing purposes.
EntityTypeTest::testGetCountLabel in core/tests/Drupal/Tests/Core/Entity/EntityTypeTest.php
@covers ::getCountLabel[[api-linebreak]]

... See full list

File

core/lib/Drupal/Core/Plugin/Context/Context.php, line 16

Namespace

Drupal\Core\Plugin\Context
View source
class Context extends ComponentContext implements ContextInterface {
  use TypedDataTrait;
  use DependencySerializationTrait;
  
  /**
   * The data associated with the context.
   *
   * @var \Drupal\Core\TypedData\TypedDataInterface
   */
  protected $contextData;
  
  /**
   * The definition to which a context must conform.
   *
   * @var \Drupal\Core\Plugin\Context\ContextDefinitionInterface
   */
  protected $contextDefinition;
  
  /**
   * The cacheability metadata.
   *
   * @var \Drupal\Core\Cache\CacheableMetadata
   */
  protected $cacheabilityMetadata;
  
  /**
   * Create a context object.
   *
   * @param \Drupal\Core\Plugin\Context\ContextDefinitionInterface $context_definition
   *   The context definition.
   * @param mixed|null $context_value
   *   The context value object.
   */
  public function __construct(ContextDefinitionInterface $context_definition, $context_value = NULL) {
    parent::__construct($context_definition, NULL);
    $this->cacheabilityMetadata = new CacheableMetadata();
    if (!is_null($context_value)) {
      $this->setContextValue($context_value);
    }
  }
  
  /**
   * {@inheritdoc}
   */
  public function getContextValue() {
    if (!isset($this->contextData)) {
      $definition = $this->getContextDefinition();
      $default_value = $definition->getDefaultValue();
      if (isset($default_value)) {
        // Keep the default value here so that subsequent calls don't have to
        // look it up again.
        $this->setContextValue($default_value);
      }
      elseif ($definition->isRequired()) {
        $type = $definition->getDataType();
        throw new ContextException("The '{$type}' context is required and not present.");
      }
      return $default_value;
    }
    return $this->getTypedDataManager()
      ->getCanonicalRepresentation($this->contextData);
  }
  
  /**
   * {@inheritdoc}
   */
  public function hasContextValue() {
    return $this->getTypedDataManager()
      ->getCanonicalRepresentation($this->getContextData()) !== NULL;
  }
  
  /**
   * Sets the context value.
   *
   * @param mixed $value
   *   The value of this context, matching the context definition.
   */
  protected function setContextValue($value) {
    // Add the value as a cacheable dependency only if implements the interface
    // to prevent it from disabling caching with a max-age 0.
    if ($value instanceof CacheableDependencyInterface) {
      $this->addCacheableDependency($value);
    }
    if ($value instanceof TypedDataInterface) {
      $this->contextData = $value;
    }
    else {
      $this->contextData = $this->getTypedDataManager()
        ->create($this->contextDefinition
        ->getDataDefinition(), $value);
    }
  }
  
  /**
   * {@inheritdoc}
   */
  public function getConstraints() {
    return $this->contextDefinition
      ->getConstraints();
  }
  
  /**
   * {@inheritdoc}
   */
  public function getContextData() {
    if (!isset($this->contextData)) {
      $definition = $this->getContextDefinition();
      $default_value = $definition->getDefaultValue();
      // Store the default value so that subsequent calls don't have to look
      // it up again.
      $this->contextData = $this->getTypedDataManager()
        ->create($definition->getDataDefinition(), $default_value);
    }
    return $this->contextData;
  }
  
  /**
   * {@inheritdoc}
   */
  public function getContextDefinition() {
    return $this->contextDefinition;
  }
  
  /**
   * {@inheritdoc}
   */
  public function validate() {
    return $this->getContextData()
      ->validate();
  }
  
  /**
   * {@inheritdoc}
   */
  public function addCacheableDependency($dependency) {
    $this->cacheabilityMetadata = $this->cacheabilityMetadata
      ->merge(CacheableMetadata::createFromObject($dependency));
    return $this;
  }
  
  /**
   * {@inheritdoc}
   */
  public function getCacheContexts() {
    return $this->cacheabilityMetadata
      ->getCacheContexts();
  }
  
  /**
   * {@inheritdoc}
   */
  public function getCacheTags() {
    return $this->cacheabilityMetadata
      ->getCacheTags();
  }
  
  /**
   * {@inheritdoc}
   */
  public function getCacheMaxAge() {
    return $this->cacheabilityMetadata
      ->getCacheMaxAge();
  }
  
  /**
   * {@inheritdoc}
   */
  public static function createFromContext(ContextInterface $old_context, $value) {
    $context = new static($old_context->getContextDefinition(), $value);
    $context->addCacheableDependency($old_context);
    if (method_exists($old_context, 'getTypedDataManager')) {
      $context->setTypedDataManager($old_context->getTypedDataManager());
    }
    return $context;
  }

}

Members

Title Sort descending Modifiers Object type Summary Overriden Title Overrides
Context::$cacheabilityMetadata protected property The cacheability metadata.
Context::$contextData protected property The data associated with the context.
Context::$contextDefinition protected property The definition to which a context must conform. Overrides Context::$contextDefinition
Context::$contextValue protected property The value of the context.
Context::addCacheableDependency public function Overrides ContextInterface::addCacheableDependency
Context::createFromContext public static function Overrides ContextInterface::createFromContext
Context::getCacheContexts public function Overrides CacheableDependencyInterface::getCacheContexts
Context::getCacheMaxAge public function Overrides CacheableDependencyInterface::getCacheMaxAge
Context::getCacheTags public function Overrides CacheableDependencyInterface::getCacheTags
Context::getConstraints public function Overrides Context::getConstraints
Context::getContextData public function Overrides ContextInterface::getContextData
Context::getContextDefinition public function Overrides Context::getContextDefinition
Context::getContextValue public function Overrides Context::getContextValue
Context::hasContextValue public function Overrides Context::hasContextValue
Context::setContextValue protected function Sets the context value.
Context::validate public function Overrides Context::validate
Context::__construct public function Create a context object. Overrides Context::__construct
DependencySerializationTrait::$_entityStorages protected property
DependencySerializationTrait::$_serviceIds protected property
DependencySerializationTrait::__sleep public function 1
DependencySerializationTrait::__wakeup public function 2
TypedDataTrait::$typedDataManager protected property The typed data manager used for creating the data types.
TypedDataTrait::getTypedDataManager public function Gets the typed data manager. 2
TypedDataTrait::setTypedDataManager public function Sets the typed data manager. 2

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