public function EntityReference::setValue in Drupal 8

Same name and namespace in other branches

1. 9 core/lib/Drupal/Core/Entity/Plugin/DataType/EntityReference.php \Drupal\Core\Entity\Plugin\DataType\EntityReference::setValue()

Sets the data value.

Parameters

mixed|null $value: The value to set in the format as documented for the data type or NULL to unset the data value.

bool $notify: (optional) Whether to notify the parent object of the change. Defaults to TRUE. If a property is updated from a parent object, set it to FALSE to avoid being notified again.

Throws

\InvalidArgumentException If the value input is inappropriate.

\Drupal\Core\TypedData\Exception\ReadOnlyException If the data is read-only.

Overrides DataReferenceBase::setValue

File

core/lib/Drupal/Core/Entity/Plugin/DataType/EntityReference.php, line 93

Class

EntityReference

Defines an 'entity_reference' data type.

Namespace

Drupal\Core\Entity\Plugin\DataType

Code

public function setValue($value, $notify = TRUE) {
  unset($this->target);
  unset($this->id);

  // Both the entity ID and the entity object may be passed as value. The
  // reference may also be unset by passing NULL as value.
  if (!isset($value)) {
    $this->target = NULL;
  }
  elseif ($value instanceof EntityInterface) {
    $this->target = $value
      ->getTypedData();
  }
  elseif (!is_scalar($value) || $this
    ->getTargetDefinition()
    ->getEntityTypeId() === NULL) {
    throw new \InvalidArgumentException('Value is not a valid entity.');
  }
  else {
    $this->id = $value;
  }

  // Notify the parent of any changes.
  if ($notify && isset($this->parent)) {
    $this->parent
      ->onChange($this->name);
  }
}