Drupal
/
drupal
mirror of https://git.drupalcode.org/project/drupal.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Issue #2137309 by fago: Typed data does not handle set() and onChange() consistently

8.0.x
Alex Pott 2014-12-14 12:48:48 +01:00
parent b665ec3dfc
commit 9f04e89ba4
11 changed files with 127 additions and 116 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
core/lib/Drupal/Core/Config/Schema/Mapping.php
View File

@ -88,7 +88,7 @@ class Mapping extends ArrayElement implements ComplexDataInterface {
if ($notify && isset($this->parent)) {
$this->parent->onChange($this->name);
}
return $property;
return $this;
}
/**

7
core/lib/Drupal/Core/Entity/ContentEntityBase.php
View File

@ -385,9 +385,10 @@ abstract class ContentEntityBase extends Entity implements \IteratorAggregate, C
* {@inheritdoc}
*/
public function set($name, $value, $notify = TRUE) {
// If default language or an entity key changes we need to react to that.
$notify = $name == 'langcode' || in_array($name, $this->getEntityType()->getKeys());
$this->get($name)->setValue($value, $notify);
// Assign the value on the child and overrule notify such that we get
// notified to handle changes afterwards. We can ignore notify as there is
// no parent to notify anyway.
$this->get($name)->setValue($value, TRUE);
}
/**

3
core/lib/Drupal/Core/Entity/Plugin/DataType/EntityAdapter.php
View File

@ -105,7 +105,8 @@ class EntityAdapter extends TypedData implements \IteratorAggregate, ComplexData
throw new \InvalidArgumentException(String::format('Unable to set unknown property @name.', array('@name' => $property_name)));
}
// This will throw an exception for unknown fields.
return $this->entity->set($property_name, $value, $notify);
$this->entity->set($property_name, $value, $notify);
return $this;
}
/**

87
core/lib/Drupal/Core/Field/FieldItemBase.php
View File

@ -105,10 +105,7 @@ abstract class FieldItemBase extends Map implements FieldItemInterface {
}
/**
* Overrides \Drupal\Core\TypedData\TypedData::setValue().
*
* @param array|null $values
* An array of property values.
* {@inheritdoc}
*/
public function setValue($values, $notify = TRUE) {
// Treat the values as property value of the first property, if no array is
@ -117,19 +114,25 @@ abstract class FieldItemBase extends Map implements FieldItemInterface {
$keys = array_keys($this->definition->getPropertyDefinitions());
$values = array($keys[0] => $values);
}
$this->values = $values;
// Update any existing property objects.
foreach ($this->properties as $name => $property) {
$value = NULL;
if (isset($values[$name])) {
$value = $values[$name];
}
$property->setValue($value, FALSE);
unset($this->values[$name]);
parent::setValue($values, $notify);
}
/**
* {@inheritdoc}
*
* Different to the parent Map class, we avoid creating property objects as
* far as possible in order to optimize performance. Thus we just update
* $this->values if no property object has been created yet.
*/
protected function writePropertyValue($property_name, $value) {
// For defined properties there is either a property object or a plain
// value that needs to be updated.
if (isset($this->properties[$property_name])) {
$this->properties[$property_name]->setValue($value, FALSE);
}
// Notify the parent of any changes.
if ($notify && isset($this->parent)) {
$this->parent->onChange($this->name);
// Allow setting plain values for not-defined properties also.
else {
$this->values[$property_name] = $value;
}
}
@ -139,31 +142,11 @@ abstract class FieldItemBase extends Map implements FieldItemInterface {
public function __get($name) {
// There is either a property object or a plain value - possibly for a
// not-defined property. If we have a plain value, directly return it.
if (isset($this->values[$name])) {
return $this->values[$name];
}
elseif (isset($this->properties[$name])) {
if (isset($this->properties[$name])) {
return $this->properties[$name]->getValue();
}
}
/**
* {@inheritdoc}
*/
public function set($property_name, $value, $notify = TRUE) {
// For defined properties there is either a property object or a plain
// value that needs to be updated.
if (isset($this->properties[$property_name])) {
$this->properties[$property_name]->setValue($value, FALSE);
unset($this->values[$property_name]);
}
// Allow setting plain values for not-defined properties also.
else {
$this->values[$property_name] = $value;
}
// Directly notify ourselves.
if ($notify) {
$this->onChange($property_name);
elseif (isset($this->values[$name])) {
return $this->values[$name];
}
}
@ -183,29 +166,23 @@ abstract class FieldItemBase extends Map implements FieldItemInterface {
* {@inheritdoc}
*/
public function __isset($name) {
return isset($this->values[$name]) || (isset($this->properties[$name]) && $this->properties[$name]->getValue() !== NULL);
if (isset($this->properties[$name])) {
return $this->properties[$name]->getValue() !== NULL;
}
return isset($this->values[$name]);
}
/**
* {@inheritdoc}
*/
public function __unset($name) {
$this->set($name, NULL);
unset($this->values[$name]);
}
/**
* Overrides \Drupal\Core\TypedData\Map::onChange().
*/
public function onChange($property_name) {
// Notify the parent of changes.
if (isset($this->parent)) {
$this->parent->onChange($this->name);
if ($this->definition->getPropertyDefinition($name)) {
$this->set($name, NULL);
}
// Remove the plain value, such that any further __get() calls go via the
// updated property object.
if (isset($this->properties[$property_name])) {
unset($this->values[$property_name]);
else {
// Explicitly unset the property in $this->values if a non-defined
// property is unset, such that its key is removed from $this->values.
unset($this->values[$name]);
}
}

18
core/lib/Drupal/Core/Field/Plugin/Field/FieldType/EntityReferenceItem.php
View File

@ -141,13 +141,9 @@ class EntityReferenceItem extends FieldItemBase {
*/
public function setValue($values, $notify = TRUE) {
if (isset($values) && !is_array($values)) {
// Directly update the property instead of invoking the parent, so it can
// handle objects and IDs.
$this->properties['entity']->setValue($values, $notify);
// If notify was FALSE, ensure the target_id property gets synched.
if (!$notify) {
$this->set('target_id', $this->properties['entity']->getTargetIdentifier(), FALSE);
}
// If either a scalar or an object was passed as the value for the item,
// assign it to the 'entity' property since that works for both cases.
$this->set('entity', $values, $notify);
}
else {
// Make sure that the 'entity' property gets set as 'target_id'.
@ -175,15 +171,15 @@ class EntityReferenceItem extends FieldItemBase {
/**
* {@inheritdoc}
*/
public function onChange($property_name) {
public function onChange($property_name, $notify = TRUE) {
// Make sure that the target ID and the target property stay in sync.
if ($property_name == 'target_id') {
$this->properties['entity']->setValue($this->target_id, FALSE);
$this->writePropertyValue('entity', $this->target_id);
}
elseif ($property_name == 'entity') {
$this->set('target_id', $this->properties['entity']->getTargetIdentifier(), FALSE);
$this->writePropertyValue('target_id', $this->get('entity')->getTargetIdentifier());
}
parent::onChange($property_name);
parent::onChange($property_name, $notify);
}
/**

18
core/lib/Drupal/Core/Field/Plugin/Field/FieldType/LanguageItem.php
View File

@ -69,14 +69,7 @@ class LanguageItem extends FieldItemBase {
// Treat the values as property value of the language property, if no array
// is given as this handles language codes and objects.
if (isset($values) && !is_array($values)) {
// Directly update the property instead of invoking the parent, so that
// the language property can take care of updating the language code
// property.
$this->properties['language']->setValue($values, $notify);
// If notify was FALSE, ensure the value property gets synched.
if (!$notify) {
$this->set('value', $this->properties['language']->getTargetIdentifier(), FALSE);
}
$this->set('language', $values, $notify);
}
else {
// Make sure that the 'language' property gets set as 'value'.
@ -100,14 +93,15 @@ class LanguageItem extends FieldItemBase {
/**
* {@inheritdoc}
*/
public function onChange($property_name) {
public function onChange($property_name, $notify = TRUE) {
// Make sure that the value and the language property stay in sync.
if ($property_name == 'value') {
$this->properties['language']->setValue($this->value, FALSE);
$this->writePropertyValue('language', $this->value);
}
elseif ($property_name == 'language') {
$this->set('value', $this->properties['language']->getTargetIdentifier(), FALSE);
$this->writePropertyValue('value', $this->get('language')->getTargetIdentifier());
}
parent::onChange($property_name);
parent::onChange($property_name, $notify);
}
}

3
core/lib/Drupal/Core/TypedData/ComplexDataInterface.php
View File

@ -53,8 +53,7 @@ interface ComplexDataInterface extends TraversableTypedDataInterface {
* TRUE. If the update stems from a parent object, set it to FALSE to avoid
* being notified again.
*
* @return \Drupal\Core\TypedData\TypedDataInterface
* The property object.
* @return $this
*
* @throws \InvalidArgumentException
* If the specified property does not exist.

46
core/lib/Drupal/Core/TypedData/Plugin/DataType/Map.php
View File

@ -94,11 +94,11 @@ class Map extends TypedData implements \IteratorAggregate, ComplexDataInterface
// Update any existing property objects.
foreach ($this->properties as $name => $property) {
$value = NULL;
if (isset($values[$name])) {
$value = $values[$name];
}
$value = isset($values[$name]) ? $values[$name] : NULL;
$property->setValue($value, FALSE);
// Remove the value from $this->values to ensure it does not contain any
// value for computed properties.
unset($this->values[$name]);
}
// Notify the parent of any changes.
if ($notify && isset($this->parent)) {
@ -134,19 +134,34 @@ class Map extends TypedData implements \IteratorAggregate, ComplexDataInterface
}
/**
* Implements \Drupal\Core\TypedData\ComplexDataInterface::set().
* {@inheritdoc}
*/
public function set($property_name, $value, $notify = TRUE) {
// Separate the writing in a protected method, such that onChange
// implementations can make use of it.
$this->writePropertyValue($property_name, $value);
$this->onChange($property_name, $notify);
return $this;
}
/**
* Writes the value of a property without handling changes.
*
* Implementations of onChange() should use this method instead of set() in
* order to avoid onChange() being triggered again.
*
* @param string $property_name
* The name of the property to be written.
* @param $value
* The value to set.
*/
protected function writePropertyValue($property_name, $value) {
if ($this->definition->getPropertyDefinition($property_name)) {
$this->get($property_name)->setValue($value, $notify);
$this->get($property_name)->setValue($value, FALSE);
}
else {
// Just set the plain value, which allows adding a new entry to the map.
$this->values[$property_name] = $value;
// Directly notify ourselves.
if ($notify) {
$this->onChange($property_name, $value);
}
}
}
@ -212,11 +227,16 @@ class Map extends TypedData implements \IteratorAggregate, ComplexDataInterface
}
/**
* Implements \Drupal\Core\TypedData\ComplexDataInterface::onChange().
* {@inheritdoc}
*
* @param bool $notify
* (optional) Whether to forward the notification to the parent. Defaults to
* TRUE. By passing FALSE, overrides of this method can re-use the logic
* of parent classes without triggering notification.
*/
public function onChange($property_name) {
public function onChange($property_name, $notify = TRUE) {
// Notify the parent of changes.
if (isset($this->parent)) {
if ($notify && isset($this->parent)) {
$this->parent->onChange($this->name);
}
}

5
core/modules/datetime/src/Plugin/Field/FieldType/DateTimeItem.php
View File

@ -131,13 +131,12 @@ class DateTimeItem extends FieldItemBase {
/**
* {@inheritdoc}
*/
public function onChange($property_name) {
parent::onChange($property_name);
public function onChange($property_name, $notify = TRUE) {
// Enforce that the computed date is recalculated.
if ($property_name == 'value') {
$this->date = NULL;
}
parent::onChange($property_name, $notify);
}
}

44
core/modules/system/src/Tests/Entity/EntityFieldTest.php
View File

@ -130,16 +130,16 @@ class EntityFieldTest extends EntityUnitTestBase {
$this->assertEqual($this->entity_user->getUsername(), $entity->user_id->entity->name->value, format_string('%entity_type: User name can be read.', array('%entity_type' => $entity_type)));
// Change the assigned user by entity.
$new_user = $this->createUser();
$entity->user_id->entity = $new_user;
$this->assertEqual($new_user->id(), $entity->user_id->target_id, format_string('%entity_type: Updated user id can be read.', array('%entity_type' => $entity_type)));
$this->assertEqual($new_user->getUsername(), $entity->user_id->entity->name->value, format_string('%entity_type: Updated username value can be read.', array('%entity_type' => $entity_type)));
$new_user1 = $this->createUser();
$entity->user_id->entity = $new_user1;
$this->assertEqual($new_user1->id(), $entity->user_id->target_id, format_string('%entity_type: Updated user id can be read.', array('%entity_type' => $entity_type)));
$this->assertEqual($new_user1->getUsername(), $entity->user_id->entity->name->value, format_string('%entity_type: Updated username value can be read.', array('%entity_type' => $entity_type)));
// Change the assigned user by id.
$new_user = $this->createUser();
$entity->user_id->target_id = $new_user->id();
$this->assertEqual($new_user->id(), $entity->user_id->target_id, format_string('%entity_type: Updated user id can be read.', array('%entity_type' => $entity_type)));
$this->assertEqual($new_user->getUsername(), $entity->user_id->entity->name->value, format_string('%entity_type: Updated username value can be read.', array('%entity_type' => $entity_type)));
$new_user2 = $this->createUser();
$entity->user_id->target_id = $new_user2->id();
$this->assertEqual($new_user2->id(), $entity->user_id->target_id, format_string('%entity_type: Updated user id can be read.', array('%entity_type' => $entity_type)));
$this->assertEqual($new_user2->getUsername(), $entity->user_id->entity->name->value, format_string('%entity_type: Updated username value can be read.', array('%entity_type' => $entity_type)));
// Try unsetting a field.
$entity->name->value = NULL;
@ -148,6 +148,34 @@ class EntityFieldTest extends EntityUnitTestBase {
$this->assertNull($entity->user_id->target_id, format_string('%entity_type: User ID field is not set.', array('%entity_type' => $entity_type)));
$this->assertNull($entity->user_id->entity, format_string('%entity_type: User entity field is not set.', array('%entity_type' => $entity_type)));
// Test setting the values via the typed data API works as well.
// Change the assigned user by entity.
$entity->user_id->first()->get('entity')->setValue($new_user2);
$this->assertEqual($new_user2->id(), $entity->user_id->target_id, format_string('%entity_type: Updated user id can be read.', array('%entity_type' => $entity_type)));
$this->assertEqual($new_user2->getUsername(), $entity->user_id->entity->name->value, format_string('%entity_type: Updated user name value can be read.', array('%entity_type' => $entity_type)));
// Change the assigned user by id.
$entity->user_id->first()->get('target_id')->setValue($new_user2->id());
$this->assertEqual($new_user2->id(), $entity->user_id->target_id, format_string('%entity_type: Updated user id can be read.', array('%entity_type' => $entity_type)));
$this->assertEqual($new_user2->getUsername(), $entity->user_id->entity->name->value, format_string('%entity_type: Updated user name value can be read.', array('%entity_type' => $entity_type)));
// Try unsetting a field.
$entity->name->first()->get('value')->setValue(NULL);
$entity->user_id->first()->get('target_id')->setValue(NULL);
$this->assertNull($entity->name->value, format_string('%entity_type: Name field is not set.', array('%entity_type' => $entity_type)));
$this->assertNull($entity->user_id->target_id, format_string('%entity_type: User ID field is not set.', array('%entity_type' => $entity_type)));
$this->assertNull($entity->user_id->entity, format_string('%entity_type: User entity field is not set.', array('%entity_type' => $entity_type)));
// Create a fresh entity so target_id does not get its property object
// instantiated, then verify setting a new value via typed data API works.
$entity2 = entity_create($entity_type, array(
'user_id' => array('target_id' => $new_user1->id()),
));
// Access the property object, and set a value.
$entity2->user_id->first()->get('target_id')->setValue($new_user2->id());
$this->assertEqual($new_user2->id(), $entity2->user_id->target_id, format_string('%entity_type: Updated user id can be read.', array('%entity_type' => $entity_type)));
$this->assertEqual($new_user2->name->value, $entity2->user_id->entity->name->value, format_string('%entity_type: Updated user name value can be read.', array('%entity_type' => $entity_type)));
// Test using isset(), empty() and unset().
$entity->name->value = 'test unset';
unset($entity->name->value);

10
core/modules/text/src/Plugin/Field/FieldType/TextItemBase.php
View File

@ -59,20 +59,16 @@ abstract class TextItemBase extends FieldItemBase {
/**
* {@inheritdoc}
*/
public function onChange($property_name) {
// Notify the parent of changes.
if (isset($this->parent)) {
$this->parent->onChange($this->name);
}
public function onChange($property_name, $notify = TRUE) {
// Unset processed properties that are affected by the change.
foreach ($this->definition->getPropertyDefinitions() as $property => $definition) {
if ($definition->getClass() == '\Drupal\text\TextProcessed') {
if ($property_name == 'format' || ($definition->getSetting('text source') == $property_name)) {
$this->set($property, NULL, FALSE);
$this->writePropertyValue($property, NULL);
}
}
}
parent::onChange($property_name, $notify);
}
/**