You are here

public function ContentEntityBase::onChange in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 core/lib/Drupal/Core/Entity/ContentEntityBase.php \Drupal\Core\Entity\ContentEntityBase::onChange()

Reacts to changes to a field.

Note that this is invoked after any changes have been applied.

Parameters

string $field_name: The name of the field which is changed.

Throws

\InvalidArgumentException When trying to assign a value to the language field that matches an existing translation.

\LogicException When trying to change:

  • The language of a translation.
  • The value of the flag identifying the default translation object.

Overrides FieldableEntityInterface::onChange

File

core/lib/Drupal/Core/Entity/ContentEntityBase.php, line 668
Contains \Drupal\Core\Entity\ContentEntityBase.

Class

ContentEntityBase
Implements Entity Field API specific enhancements to the Entity class.

Namespace

Drupal\Core\Entity

Code

public function onChange($name) {

  // Check if the changed name is the value of an entity key and if the value
  // of that is currently cached, if so, reset it. Exclude the bundle from
  // that check, as it ready only and must not change, unsetting it could
  // lead to recursions.
  if ($key = array_search($name, $this
    ->getEntityType()
    ->getKeys())) {
    if ($key != 'bundle') {
      if (isset($this->entityKeys[$key])) {
        unset($this->entityKeys[$key]);
      }
      elseif (isset($this->translatableEntityKeys[$key][$this->activeLangcode])) {
        unset($this->translatableEntityKeys[$key][$this->activeLangcode]);
      }
    }
  }
  switch ($name) {
    case $this->langcodeKey:
      if ($this
        ->isDefaultTranslation()) {

        // Update the default internal language cache.
        $this
          ->setDefaultLangcode();
        if (isset($this->translations[$this->defaultLangcode])) {
          $message = SafeMarkup::format('A translation already exists for the specified language (@langcode).', array(
            '@langcode' => $this->defaultLangcode,
          ));
          throw new \InvalidArgumentException($message);
        }
        $this
          ->updateFieldLangcodes($this->defaultLangcode);
      }
      else {

        // @todo Allow the translation language to be changed. See
        //   https://www.drupal.org/node/2443989.
        $items = $this
          ->get($this->langcodeKey);
        if ($items->value != $this->activeLangcode) {
          $items
            ->setValue($this->activeLangcode, FALSE);
          $message = SafeMarkup::format('The translation language cannot be changed (@langcode).', array(
            '@langcode' => $this->activeLangcode,
          ));
          throw new \LogicException($message);
        }
      }
      break;
    case $this->defaultLangcodeKey:

      // @todo Use a standard method to make the default_langcode field
      //   read-only. See https://www.drupal.org/node/2443991.
      if (isset($this->values[$this->defaultLangcodeKey]) && $this
        ->get($this->defaultLangcodeKey)->value != $this
        ->isDefaultTranslation()) {
        $this
          ->get($this->defaultLangcodeKey)
          ->setValue($this
          ->isDefaultTranslation(), FALSE);
        $message = SafeMarkup::format('The default translation flag cannot be changed (@langcode).', array(
          '@langcode' => $this->activeLangcode,
        ));
        throw new \LogicException($message);
      }
      break;
  }
}