diff --git a/core/lib/Drupal/Core/File/FileStorageController.php b/core/lib/Drupal/Core/File/FileStorageController.php index dd8ee7a..940e1fd 100644 --- a/core/lib/Drupal/Core/File/FileStorageController.php +++ b/core/lib/Drupal/Core/File/FileStorageController.php @@ -8,7 +8,7 @@ namespace Drupal\Core\File; use Drupal\entity\DatabaseStorageController; -use Drupal\entity\StorableInterface; +use Drupal\entity\EntityInterface; /** * File storage controller for files. @@ -34,7 +34,7 @@ public function create(array $values) { /** * Overrides Drupal\entity\DatabaseStorageController::presave(). */ - protected function preSave(StorableInterface $entity) { + protected function preSave(EntityInterface $entity) { $entity->timestamp = REQUEST_TIME; $entity->filesize = filesize($entity->uri); if (!isset($entity->langcode)) { diff --git a/core/modules/comment/lib/Drupal/comment/CommentStorageController.php b/core/modules/comment/lib/Drupal/comment/CommentStorageController.php index 50669a8..5dcda40 100644 --- a/core/modules/comment/lib/Drupal/comment/CommentStorageController.php +++ b/core/modules/comment/lib/Drupal/comment/CommentStorageController.php @@ -7,7 +7,7 @@ namespace Drupal\comment; -use Drupal\entity\StorableInterface; +use Drupal\entity\EntityInterface; use Drupal\entity\DatabaseStorageController; use LogicException; @@ -58,7 +58,7 @@ protected function attachLoad(&$comments, $load_revision = FALSE) { * @see comment_int_to_alphadecimal() * @see comment_alphadecimal_to_int() */ - protected function preSave(StorableInterface $comment) { + protected function preSave(EntityInterface $comment) { global $user; if (!isset($comment->status)) { @@ -151,7 +151,7 @@ protected function preSave(StorableInterface $comment) { /** * Overrides Drupal\entity\DatabaseStorageController::postSave(). */ - protected function postSave(StorableInterface $comment, $update) { + protected function postSave(EntityInterface $comment, $update) { $this->releaseThreadLock(); // Update the {node_comment_statistics} table prior to executing the hook. $this->updateNodeStatistics($comment->nid); diff --git a/core/modules/config/lib/Drupal/config/ConfigStorageController.php b/core/modules/config/lib/Drupal/config/ConfigStorageController.php index 57c2583..3d5fec6 100644 --- a/core/modules/config/lib/Drupal/config/ConfigStorageController.php +++ b/core/modules/config/lib/Drupal/config/ConfigStorageController.php @@ -8,7 +8,7 @@ namespace Drupal\config; use Drupal\Component\Uuid\Uuid; -use Drupal\entity\StorableInterface; +use Drupal\entity\EntityInterface; use Drupal\entity\StorageControllerInterface; /** @@ -248,7 +248,7 @@ public function delete($ids) { /** * Implements Drupal\entity\StorageControllerInterface::save(). */ - public function save(StorableInterface $entity) { + public function save(EntityInterface $entity) { $prefix = $this->entityInfo['config prefix'] . '.'; // Load the stored entity, if any. @@ -300,7 +300,7 @@ public function save(StorableInterface $entity) { * * Used before the entity is saved and before invoking the presave hook. */ - protected function preSave(StorableInterface $entity) { + protected function preSave(EntityInterface $entity) { } /** @@ -313,7 +313,7 @@ protected function preSave(StorableInterface $entity) { * (bool) TRUE if the entity has been updated, or FALSE if it has been * inserted. */ - protected function postSave(StorableInterface $entity, $update) { + protected function postSave(EntityInterface $entity, $update) { // Delete the original configurable entity, in case the entity ID was // renamed. if ($update && !empty($entity->original) && $entity->{$this->idKey} !== $entity->original->{$this->idKey}) { @@ -347,7 +347,7 @@ protected function postDelete($entities) { * @param $entity * The entity object. */ - protected function invokeHook($hook, StorableInterface $entity) { + protected function invokeHook($hook, EntityInterface $entity) { // Invoke the hook. module_invoke_all($this->entityType . '_' . $hook, $entity); // Invoke the respective entity-level hook. diff --git a/core/modules/config/lib/Drupal/config/ConfigurableBase.php b/core/modules/config/lib/Drupal/config/ConfigurableBase.php index a8bc318..58ceeff 100644 --- a/core/modules/config/lib/Drupal/config/ConfigurableBase.php +++ b/core/modules/config/lib/Drupal/config/ConfigurableBase.php @@ -7,12 +7,12 @@ namespace Drupal\config; -use Drupal\entity\StorableBase; +use Drupal\entity\Entity; /** * Defines a base configurable entity class. */ -abstract class ConfigurableBase extends StorableBase implements ConfigurableInterface { +abstract class ConfigurableBase extends Entity implements ConfigurableInterface { /** * The original ID of the configurable entity. diff --git a/core/modules/config/lib/Drupal/config/ConfigurableInterface.php b/core/modules/config/lib/Drupal/config/ConfigurableInterface.php index bf49b9b..2ac9bb3 100644 --- a/core/modules/config/lib/Drupal/config/ConfigurableInterface.php +++ b/core/modules/config/lib/Drupal/config/ConfigurableInterface.php @@ -7,12 +7,12 @@ namespace Drupal\config; -use Drupal\entity\StorableInterface; +use Drupal\entity\EntityInterface; /** * Defines the interface common for all configurable entities. */ -interface ConfigurableInterface extends StorableInterface { +interface ConfigurableInterface extends EntityInterface { /** * Returns the original ID. diff --git a/core/modules/entity/lib/Drupal/entity/ContentInterface.php b/core/modules/entity/lib/Drupal/entity/ContentInterface.php new file mode 100644 index 0000000..cb1850d --- /dev/null +++ b/core/modules/entity/lib/Drupal/entity/ContentInterface.php @@ -0,0 +1,15 @@ +entityInfo['entity class'])) { // We provide the necessary arguments for PDO to create objects of the // specified entity class. - // @see Drupal\entity\StorableInterface::__construct() + // @see Drupal\entity\EntityInterface::__construct() $query_result->setFetchMode(PDO::FETCH_CLASS, $this->entityInfo['entity class'], array(array(), $this->entityType)); } $queried_entities = $query_result->fetchAllAssoc($this->idKey); @@ -457,7 +457,7 @@ public function delete($ids) { /** * Implements Drupal\entity\EntityStorageControllerInterface::save(). */ - public function save(StorableInterface $entity) { + public function save(EntityInterface $entity) { $transaction = db_transaction(); try { // Load the stored entity, if any. @@ -502,7 +502,7 @@ public function save(StorableInterface $entity) { * * Used before the entity is saved and before invoking the presave hook. */ - protected function preSave(StorableInterface $entity) { } + protected function preSave(EntityInterface $entity) { } /** * Acts on a saved entity before the insert or update hook is invoked. @@ -514,7 +514,7 @@ protected function preSave(StorableInterface $entity) { } * (bool) TRUE if the entity has been updated, or FALSE if it has been * inserted. */ - protected function postSave(StorableInterface $entity, $update) { } + protected function postSave(EntityInterface $entity, $update) { } /** * Acts on entities before they are deleted. @@ -538,7 +538,7 @@ protected function postDelete($entities) { } * @param $entity * The entity object. */ - protected function invokeHook($hook, StorableInterface $entity) { + protected function invokeHook($hook, EntityInterface $entity) { if (!empty($this->entityInfo['fieldable']) && function_exists($function = 'field_attach_' . $hook)) { $function($this->entityType, $entity); } diff --git a/core/modules/entity/lib/Drupal/entity/Entity.php b/core/modules/entity/lib/Drupal/entity/Entity.php index 6660fc7..2d6ac5c 100644 --- a/core/modules/entity/lib/Drupal/entity/Entity.php +++ b/core/modules/entity/lib/Drupal/entity/Entity.php @@ -17,6 +17,271 @@ * This class can be used as-is by simple entity types. Entity types requiring * special handling can extend the class. */ -class Entity extends StorableBase implements EntityInterface { +class Entity implements EntityInterface { + + /** + * The language code of the entity's default language. + * + * @var string + */ + public $langcode = LANGUAGE_NOT_SPECIFIED; + + /** + * The entity type. + * + * @var string + */ + protected $entityType; + + /** + * Boolean indicating whether the entity should be forced to be new. + * + * @var bool + */ + protected $enforceIsNew; + + /** + * Indicates whether this is the current revision. + * + * @var bool + */ + public $isCurrentRevision = TRUE; + + /** + * Constructs a new entity object. + */ + public function __construct(array $values = array(), $entity_type) { + $this->entityType = $entity_type; + // Set initial values. + foreach ($values as $key => $value) { + $this->$key = $value; + } + } + + /** + * Implements EntityInterface::id(). + */ + public function id() { + return isset($this->id) ? $this->id : NULL; + } + + /** + * Implements EntityInterface::uuid(). + */ + public function uuid() { + return isset($this->uuid) ? $this->uuid : NULL; + } + + /** + * Implements EntityInterface::isNew(). + */ + public function isNew() { + return !empty($this->enforceIsNew) || !$this->id(); + } + + /** + * Implements EntityInterface::enforceIsNew(). + */ + public function enforceIsNew($value = TRUE) { + $this->enforceIsNew = $value; + } + + /** + * Implements EntityInterface::entityType(). + */ + public function entityType() { + return $this->entityType; + } + + /** + * Implements EntityInterface::bundle(). + */ + public function bundle() { + return $this->entityType; + } + + /** + * Implements EntityInterface::label(). + */ + public function label($langcode = NULL) { + $label = NULL; + $entity_info = $this->entityInfo(); + if (isset($entity_info['label callback']) && function_exists($entity_info['label callback'])) { + $label = $entity_info['label callback']($this->entityType, $this, $langcode); + } + elseif (!empty($entity_info['entity keys']['label']) && isset($this->{$entity_info['entity keys']['label']})) { + $label = $this->{$entity_info['entity keys']['label']}; + } + return $label; + } + + /** + * Implements EntityInterface::uri(). + */ + public function uri() { + $bundle = $this->bundle(); + // A bundle-specific callback takes precedence over the generic one for the + // entity type. + $entity_info = $this->entityInfo(); + if (isset($entity_info['bundles'][$bundle]['uri callback'])) { + $uri_callback = $entity_info['bundles'][$bundle]['uri callback']; + } + elseif (isset($entity_info['uri callback'])) { + $uri_callback = $entity_info['uri callback']; + } + else { + return NULL; + } + + // Invoke the callback to get the URI. If there is no callback, return NULL. + if (isset($uri_callback) && function_exists($uri_callback)) { + $uri = $uri_callback($this); + // Pass the entity data to url() so that alter functions do not need to + // look up this entity again. + $uri['options']['entity_type'] = $this->entityType; + $uri['options']['entity'] = $this; + return $uri; + } + } + + /** + * Implements EntityInterface::language(). + */ + public function language() { + // @todo: Check for language.module instead, once Field API language + // handling depends upon it too. + return module_exists('locale') ? language_load($this->langcode) : FALSE; + } + + /** + * Implements EntityInterface::translations(). + */ + public function translations() { + $languages = array(); + $entity_info = $this->entityInfo(); + if ($entity_info['fieldable'] && ($default_language = $this->language())) { + // Go through translatable properties and determine all languages for + // which translated values are available. + foreach (field_info_instances($this->entityType, $this->bundle()) as $field_name => $instance) { + $field = field_info_field($field_name); + if (field_is_translatable($this->entityType, $field) && isset($this->$field_name)) { + foreach ($this->$field_name as $langcode => $value) { + $languages[$langcode] = TRUE; + } + } + } + // Remove the default language from the translations. + unset($languages[$default_language->langcode]); + $languages = array_intersect_key(language_list(), $languages); + } + return $languages; + } + + /** + * Implements EntityInterface::get(). + */ + public function get($property_name, $langcode = NULL) { + // Handle fields. + $entity_info = $this->entityInfo(); + if ($entity_info['fieldable'] && field_info_instance($this->entityType, $property_name, $this->bundle())) { + $field = field_info_field($property_name); + $langcode = $this->getFieldLangcode($field, $langcode); + return isset($this->{$property_name}[$langcode]) ? $this->{$property_name}[$langcode] : NULL; + } + else { + // Handle properties being not fields. + // @todo: Add support for translatable properties being not fields. + return isset($this->{$property_name}) ? $this->{$property_name} : NULL; + } + } + + /** + * Implements EntityInterface::set(). + */ + public function set($property_name, $value, $langcode = NULL) { + // Handle fields. + $entity_info = $this->entityInfo(); + if ($entity_info['fieldable'] && field_info_instance($this->entityType, $property_name, $this->bundle())) { + $field = field_info_field($property_name); + $langcode = $this->getFieldLangcode($field, $langcode); + $this->{$property_name}[$langcode] = $value; + } + else { + // Handle properties being not fields. + // @todo: Add support for translatable properties being not fields. + $this->{$property_name} = $value; + } + } + + /** + * Determines the language code to use for accessing a field value in a certain language. + */ + protected function getFieldLangcode($field, $langcode = NULL) { + // Only apply the given langcode if the entity is language-specific. + // Otherwise translatable fields are handled as non-translatable fields. + if (field_is_translatable($this->entityType, $field) && ($default_language = $this->language()) && !language_is_locked($this->langcode)) { + // For translatable fields the values in default language are stored using + // the language code of the default language. + return isset($langcode) ? $langcode : $default_language->langcode; + } + else { + // If there is a langcode defined for this field, just return it. Otherwise + // return LANGUAGE_NOT_SPECIFIED. + return (isset($this->langcode) ? $this->langcode : LANGUAGE_NOT_SPECIFIED); + } + } + + /** + * Implements EntityInterface::save(). + */ + public function save() { + return entity_get_controller($this->entityType)->save($this); + } + + /** + * Implements EntityInterface::delete(). + */ + public function delete() { + if (!$this->isNew()) { + entity_get_controller($this->entityType)->delete(array($this->id())); + } + } + + /** + * Implements EntityInterface::createDuplicate(). + */ + public function createDuplicate() { + $duplicate = clone $this; + $entity_info = $this->entityInfo(); + $this->{$entity_info['entity keys']['id']} = NULL; + + // Check if the entity type supports UUIDs and generate a new one if so. + if (!empty($entity_info['entity keys']['uuid'])) { + $uuid = new Uuid(); + $duplicate->{$entity_info['entity keys']['uuid']} = $uuid->generate(); + } + return $duplicate; + } + + /** + * Implements EntityInterface::entityInfo(). + */ + public function entityInfo() { + return entity_get_info($this->entityType); + } + + /** + * Implements Drupal\entity\EntityInterface::getRevisionId(). + */ + public function getRevisionId() { + return NULL; + } + + /** + * Implements Drupal\entity\EntityInterface::isCurrentRevision(). + */ + public function isCurrentRevision() { + return $this->isCurrentRevision; + } } diff --git a/core/modules/entity/lib/Drupal/entity/EntityInterface.php b/core/modules/entity/lib/Drupal/entity/EntityInterface.php index 1fc1d0a..a111d55 100644 --- a/core/modules/entity/lib/Drupal/entity/EntityInterface.php +++ b/core/modules/entity/lib/Drupal/entity/EntityInterface.php @@ -10,6 +10,209 @@ /** * Defines a common interface for all entity objects. */ -interface EntityInterface extends StorableInterface { +interface EntityInterface { + /** + * Constructs a new entity object. + * + * @param $values + * An array of values to set, keyed by property name. If the entity type + * has bundles, the bundle key has to be specified. + * @param $entity_type + * The type of the entity to create. + */ + public function __construct(array $values, $entity_type); + + /** + * Returns the entity identifier (the entity's machine name or numeric ID). + * + * @return + * The identifier of the entity, or NULL if the entity does not yet have + * an identifier. + */ + public function id(); + + /** + * Returns the entity UUID (Universally Unique Identifier). + * + * The UUID is guaranteed to be unique and can be used to identify an entity + * across multiple systems. + * + * @return string + * The UUID of the entity, or NULL if the entity does not have one. + */ + public function uuid(); + + /** + * Returns whether the entity is new. + * + * Usually an entity is new if no ID exists for it yet. However, entities may + * be enforced to be new with existing IDs too. + * + * @return + * TRUE if the entity is new, or FALSE if the entity has already been saved. + * + * @see Drupal\entity\EntityInterface::enforceIsNew() + */ + public function isNew(); + + /** + * Enforces an entity to be new. + * + * Allows migrations to create entities with pre-defined IDs by forcing the + * entity to be new before saving. + * + * @param bool $value + * (optional) Whether the entity should be forced to be new. Defaults to + * TRUE. + * + * @see Drupal\entity\EntityInterface::isNew() + */ + public function enforceIsNew($value = TRUE); + + /** + * Returns the type of the entity. + * + * @return + * The type of the entity. + */ + public function entityType(); + + /** + * Returns the bundle of the entity. + * + * @return + * The bundle of the entity. Defaults to the entity type if the entity type + * does not make use of different bundles. + */ + public function bundle(); + + /** + * Returns the label of the entity. + * + * @param $langcode + * (optional) The language code of the language that should be used for + * getting the label. If set to NULL, the entity's default language is + * used. + * + * @return + * The label of the entity, or NULL if there is no label defined. + */ + public function label($langcode = NULL); + + /** + * Returns the URI elements of the entity. + * + * @return + * An array containing the 'path' and 'options' keys used to build the URI + * of the entity, and matching the signature of url(). NULL if the entity + * has no URI of its own. + */ + public function uri(); + + /** + * Returns the default language of a language-specific entity. + * + * @return + * The language object of the entity's default language, or FALSE if the + * entity is not language-specific. + * + * @see Drupal\entity\EntityInterface::translations() + */ + public function language(); + + /** + * Returns the languages the entity is translated to. + * + * @return + * An array of language objects, keyed by language codes. + * + * @see Drupal\entity\EntityInterface::language() + */ + public function translations(); + + /** + * Returns the value of an entity property. + * + * @param $property_name + * The name of the property to return; e.g., 'title'. + * @param $langcode + * (optional) If the property is translatable, the language code of the + * language that should be used for getting the property. If set to NULL, + * the entity's default language is being used. + * + * @return + * The property value, or NULL if it is not defined. + * + * @see Drupal\entity\EntityInterface::language() + */ + public function get($property_name, $langcode = NULL); + + /** + * Sets the value of an entity property. + * + * @param $property_name + * The name of the property to set; e.g., 'title'. + * @param $value + * The value to set, or NULL to unset the property. + * @param $langcode + * (optional) If the property is translatable, the language code of the + * language that should be used for setting the property. If set to NULL, + * the entity's default language is being used. + * + * @see Drupal\entity\EntityInterface::language() + */ + public function set($property_name, $value, $langcode = NULL); + + /** + * Saves an entity permanently. + * + * @return + * Either SAVED_NEW or SAVED_UPDATED, depending on the operation performed. + * + * @throws Drupal\entity\EntityStorageException + * In case of failures an exception is thrown. + */ + public function save(); + + /** + * Deletes an entity permanently. + * + * @throws Drupal\entity\EntityStorageException + * In case of failures an exception is thrown. + */ + public function delete(); + + /** + * Creates a duplicate of the entity. + * + * @return Drupal\entity\EntityInterface + * A clone of the current entity with all identifiers unset, so saving + * it inserts a new entity into the storage system. + */ + public function createDuplicate(); + + /** + * Returns the info of the type of the entity. + * + * @see entity_get_info() + */ + public function entityInfo(); + + /** + * Returns the revision identifier of the entity. + * + * @return + * The revision identifier of the entity, or NULL if the entity does not + * have a revision identifier. + */ + public function getRevisionId(); + + /** + * Checks if this entity is the current revision. + * + * @return bool + * TRUE if the entity is the current revision, FALSE otherwise. + */ + public function isCurrentRevision(); } diff --git a/core/modules/entity/lib/Drupal/entity/StorableBase.php b/core/modules/entity/lib/Drupal/entity/StorableBase.php deleted file mode 100644 index 57bf352..0000000 --- a/core/modules/entity/lib/Drupal/entity/StorableBase.php +++ /dev/null @@ -1,286 +0,0 @@ -entityType = $entity_type; - // Set initial values. - foreach ($values as $key => $value) { - $this->$key = $value; - } - } - - /** - * Implements StorableInterface::id(). - */ - public function id() { - return isset($this->id) ? $this->id : NULL; - } - - /** - * Implements StorableInterface::uuid(). - */ - public function uuid() { - return isset($this->uuid) ? $this->uuid : NULL; - } - - /** - * Implements StorableInterface::isNew(). - */ - public function isNew() { - return !empty($this->enforceIsNew) || !$this->id(); - } - - /** - * Implements StorableInterface::enforceIsNew(). - */ - public function enforceIsNew($value = TRUE) { - $this->enforceIsNew = $value; - } - - /** - * Implements StorableInterface::entityType(). - */ - public function entityType() { - return $this->entityType; - } - - /** - * Implements StorableInterface::bundle(). - */ - public function bundle() { - return $this->entityType; - } - - /** - * Implements StorableInterface::label(). - */ - public function label($langcode = NULL) { - $label = NULL; - $entity_info = $this->entityInfo(); - if (isset($entity_info['label callback']) && function_exists($entity_info['label callback'])) { - $label = $entity_info['label callback']($this->entityType, $this, $langcode); - } - elseif (!empty($entity_info['entity keys']['label']) && isset($this->{$entity_info['entity keys']['label']})) { - $label = $this->{$entity_info['entity keys']['label']}; - } - return $label; - } - - /** - * Implements StorableInterface::uri(). - */ - public function uri() { - $bundle = $this->bundle(); - // A bundle-specific callback takes precedence over the generic one for the - // entity type. - $entity_info = $this->entityInfo(); - if (isset($entity_info['bundles'][$bundle]['uri callback'])) { - $uri_callback = $entity_info['bundles'][$bundle]['uri callback']; - } - elseif (isset($entity_info['uri callback'])) { - $uri_callback = $entity_info['uri callback']; - } - else { - return NULL; - } - - // Invoke the callback to get the URI. If there is no callback, return NULL. - if (isset($uri_callback) && function_exists($uri_callback)) { - $uri = $uri_callback($this); - // Pass the entity data to url() so that alter functions do not need to - // look up this entity again. - $uri['options']['entity_type'] = $this->entityType; - $uri['options']['entity'] = $this; - return $uri; - } - } - - /** - * Implements StorableInterface::language(). - */ - public function language() { - // @todo: Check for language.module instead, once Field API language - // handling depends upon it too. - return module_exists('locale') ? language_load($this->langcode) : FALSE; - } - - /** - * Implements StorableInterface::translations(). - */ - public function translations() { - $languages = array(); - $entity_info = $this->entityInfo(); - if ($entity_info['fieldable'] && ($default_language = $this->language())) { - // Go through translatable properties and determine all languages for - // which translated values are available. - foreach (field_info_instances($this->entityType, $this->bundle()) as $field_name => $instance) { - $field = field_info_field($field_name); - if (field_is_translatable($this->entityType, $field) && isset($this->$field_name)) { - foreach ($this->$field_name as $langcode => $value) { - $languages[$langcode] = TRUE; - } - } - } - // Remove the default language from the translations. - unset($languages[$default_language->langcode]); - $languages = array_intersect_key(language_list(), $languages); - } - return $languages; - } - - /** - * Implements StorableInterface::get(). - */ - public function get($property_name, $langcode = NULL) { - // Handle fields. - $entity_info = $this->entityInfo(); - if ($entity_info['fieldable'] && field_info_instance($this->entityType, $property_name, $this->bundle())) { - $field = field_info_field($property_name); - $langcode = $this->getFieldLangcode($field, $langcode); - return isset($this->{$property_name}[$langcode]) ? $this->{$property_name}[$langcode] : NULL; - } - else { - // Handle properties being not fields. - // @todo: Add support for translatable properties being not fields. - return isset($this->{$property_name}) ? $this->{$property_name} : NULL; - } - } - - /** - * Implements StorableInterface::set(). - */ - public function set($property_name, $value, $langcode = NULL) { - // Handle fields. - $entity_info = $this->entityInfo(); - if ($entity_info['fieldable'] && field_info_instance($this->entityType, $property_name, $this->bundle())) { - $field = field_info_field($property_name); - $langcode = $this->getFieldLangcode($field, $langcode); - $this->{$property_name}[$langcode] = $value; - } - else { - // Handle properties being not fields. - // @todo: Add support for translatable properties being not fields. - $this->{$property_name} = $value; - } - } - - /** - * Determines the language code to use for accessing a field value in a certain language. - */ - protected function getFieldLangcode($field, $langcode = NULL) { - // Only apply the given langcode if the entity is language-specific. - // Otherwise translatable fields are handled as non-translatable fields. - if (field_is_translatable($this->entityType, $field) && ($default_language = $this->language()) && !language_is_locked($this->langcode)) { - // For translatable fields the values in default language are stored using - // the language code of the default language. - return isset($langcode) ? $langcode : $default_language->langcode; - } - else { - // If there is a langcode defined for this field, just return it. Otherwise - // return LANGUAGE_NOT_SPECIFIED. - return (isset($this->langcode) ? $this->langcode : LANGUAGE_NOT_SPECIFIED); - } - } - - /** - * Implements StorableInterface::save(). - */ - public function save() { - return entity_get_controller($this->entityType)->save($this); - } - - /** - * Implements StorableInterface::delete(). - */ - public function delete() { - if (!$this->isNew()) { - entity_get_controller($this->entityType)->delete(array($this->id())); - } - } - - /** - * Implements StorableInterface::createDuplicate(). - */ - public function createDuplicate() { - $duplicate = clone $this; - $entity_info = $this->entityInfo(); - $this->{$entity_info['entity keys']['id']} = NULL; - - // Check if the entity type supports UUIDs and generate a new one if so. - if (!empty($entity_info['entity keys']['uuid'])) { - $uuid = new Uuid(); - $duplicate->{$entity_info['entity keys']['uuid']} = $uuid->generate(); - } - return $duplicate; - } - - /** - * Implements StorableInterface::entityInfo(). - */ - public function entityInfo() { - return entity_get_info($this->entityType); - } - - /** - * Implements Drupal\entity\StorableInterface::getRevisionId(). - */ - public function getRevisionId() { - return NULL; - } - - /** - * Implements Drupal\entity\StorableInterface::isCurrentRevision(). - */ - public function isCurrentRevision() { - return $this->isCurrentRevision; - } -} diff --git a/core/modules/entity/lib/Drupal/entity/StorableInterface.php b/core/modules/entity/lib/Drupal/entity/StorableInterface.php deleted file mode 100644 index 23bc1ea..0000000 --- a/core/modules/entity/lib/Drupal/entity/StorableInterface.php +++ /dev/null @@ -1,218 +0,0 @@ -language()) ? $language->langcode : LANGUAGE_NOT_SPECIFIED; $langcodes = array_keys($entity->translations()); $langcodes[] = $default_langcode; diff --git a/core/modules/field/tests/modules/field_test/lib/Drupal/field_test/TestEntityController.php b/core/modules/field/tests/modules/field_test/lib/Drupal/field_test/TestEntityController.php index 49129ca..3bdab77 100644 --- a/core/modules/field/tests/modules/field_test/lib/Drupal/field_test/TestEntityController.php +++ b/core/modules/field/tests/modules/field_test/lib/Drupal/field_test/TestEntityController.php @@ -8,7 +8,7 @@ namespace Drupal\field_test; use Drupal\entity\DatabaseStorageController; -use Drupal\entity\StorableInterface; +use Drupal\entity\EntityInterface; /** * Controller class for the test entity entity types. @@ -18,7 +18,7 @@ class TestEntityController extends DatabaseStorageController { /** * Overrides Drupal\entity\DatabaseStorageController::preSave(). */ - public function preSave(StorableInterface $entity) { + public function preSave(EntityInterface $entity) { // Prepare for a new revision. if (!$entity->isNew() && !empty($entity->revision)) { $entity->old_ftvid = $entity->ftvid; @@ -29,7 +29,7 @@ public function preSave(StorableInterface $entity) { /** * Overrides Drupal\entity\DatabaseStorageController::postSave(). */ - public function postSave(StorableInterface $entity, $update) { + public function postSave(EntityInterface $entity, $update) { // Only the test_entity entity type has revisions. if ($entity->entityType() == 'test_entity') { $update_entity = TRUE; diff --git a/core/modules/node/lib/Drupal/node/NodeStorageController.php b/core/modules/node/lib/Drupal/node/NodeStorageController.php index ee47546..898aa71 100644 --- a/core/modules/node/lib/Drupal/node/NodeStorageController.php +++ b/core/modules/node/lib/Drupal/node/NodeStorageController.php @@ -8,7 +8,7 @@ namespace Drupal\node; use Drupal\entity\DatabaseStorageController; -use Drupal\entity\StorableInterface; +use Drupal\entity\EntityInterface; use Drupal\entity\EntityStorageException; use Exception; @@ -82,7 +82,7 @@ public function delete($ids) { /** * Overrides Drupal\entity\DatabaseStorageController::save(). */ - public function save(StorableInterface $entity) { + public function save(EntityInterface $entity) { $transaction = db_transaction(); try { // Load the stored entity, if any. @@ -129,10 +129,10 @@ public function save(StorableInterface $entity) { /** * Saves a node revision. * - * @param Drupal\entity\StorableInterface $node + * @param Drupal\entity\EntityInterface $node * The node entity. */ - protected function saveRevision(StorableInterface $entity) { + protected function saveRevision(EntityInterface $entity) { $record = clone $entity; $record->uid = $entity->revision_uid; $record->timestamp = $entity->revision_timestamp; @@ -197,7 +197,7 @@ protected function buildQuery($ids, $revision_id = FALSE) { /** * Overrides Drupal\entity\DatabaseStorageController::invokeHook(). */ - protected function invokeHook($hook, StorableInterface $node) { + protected function invokeHook($hook, EntityInterface $node) { if ($hook == 'insert' || $hook == 'update') { node_invoke($node, $hook); } @@ -246,7 +246,7 @@ protected function invokeHook($hook, StorableInterface $node) { /** * Overrides Drupal\entity\DatabaseStorageController::preSave(). */ - protected function preSave(StorableInterface $node) { + protected function preSave(EntityInterface $node) { // Before saving the node, set changed and revision times. $node->changed = REQUEST_TIME; @@ -262,7 +262,7 @@ protected function preSave(StorableInterface $node) { /** * Overrides Drupal\entity\DatabaseStorageController::postSave(). */ - function postSave(StorableInterface $node, $update) { + function postSave(EntityInterface $node, $update) { node_access_acquire_grants($node, $update); } diff --git a/core/modules/taxonomy/lib/Drupal/taxonomy/TermStorageController.php b/core/modules/taxonomy/lib/Drupal/taxonomy/TermStorageController.php index e90699d..961ebf0 100644 --- a/core/modules/taxonomy/lib/Drupal/taxonomy/TermStorageController.php +++ b/core/modules/taxonomy/lib/Drupal/taxonomy/TermStorageController.php @@ -7,7 +7,7 @@ namespace Drupal\taxonomy; -use Drupal\entity\StorableInterface; +use Drupal\entity\EntityInterface; use Drupal\entity\DatabaseStorageController; /** @@ -99,7 +99,7 @@ protected function postDelete($entities) { /** * Overrides Drupal\entity\DatabaseStorageController::postSave(). */ - protected function postSave(StorableInterface $entity, $update) { + protected function postSave(EntityInterface $entity, $update) { if (isset($entity->parent)) { db_delete('taxonomy_term_hierarchy') ->condition('tid', $entity->tid) diff --git a/core/modules/taxonomy/lib/Drupal/taxonomy/VocabularyStorageController.php b/core/modules/taxonomy/lib/Drupal/taxonomy/VocabularyStorageController.php index 77f5ce7..8f4ef5b 100644 --- a/core/modules/taxonomy/lib/Drupal/taxonomy/VocabularyStorageController.php +++ b/core/modules/taxonomy/lib/Drupal/taxonomy/VocabularyStorageController.php @@ -7,7 +7,7 @@ namespace Drupal\taxonomy; -use Drupal\entity\StorableInterface; +use Drupal\entity\EntityInterface; use Drupal\entity\DatabaseStorageController; /** @@ -29,7 +29,7 @@ protected function buildQuery($ids, $revision_id = FALSE) { /** * Overrides Drupal\entity\DatabaseStorageController::postSave(). */ - protected function postSave(StorableInterface $entity, $update) { + protected function postSave(EntityInterface $entity, $update) { if (!$update) { field_attach_create_bundle('taxonomy_term', $entity->machine_name); } diff --git a/core/modules/user/lib/Drupal/user/UserStorageController.php b/core/modules/user/lib/Drupal/user/UserStorageController.php index bb1d9d2..3e2ac68 100644 --- a/core/modules/user/lib/Drupal/user/UserStorageController.php +++ b/core/modules/user/lib/Drupal/user/UserStorageController.php @@ -7,7 +7,7 @@ namespace Drupal\user; -use Drupal\entity\StorableInterface; +use Drupal\entity\EntityInterface; use Drupal\entity\EntityMalformedException; use Drupal\entity\DatabaseStorageController; @@ -75,7 +75,7 @@ public function create(array $values) { /** * Overrides Drupal\entity\DatabaseStorageController::save(). */ - public function save(StorableInterface $entity) { + public function save(EntityInterface $entity) { if (empty($entity->uid)) { $entity->uid = db_next_id(db_query('SELECT MAX(uid) FROM {users}')->fetchField()); $entity->enforceIsNew(); @@ -86,7 +86,7 @@ public function save(StorableInterface $entity) { /** * Overrides Drupal\entity\DatabaseStorageController::preSave(). */ - protected function preSave(StorableInterface $entity) { + protected function preSave(EntityInterface $entity) { // Update the user password if it has changed. if ($entity->isNew() || (!empty($entity->pass) && $entity->pass != $entity->original->pass)) { // Allow alternate password hashing schemes. @@ -160,7 +160,7 @@ protected function preSave(StorableInterface $entity) { /** * Overrides Drupal\entity\DatabaseStorageController::postSave(). */ - protected function postSave(StorableInterface $entity, $update) { + protected function postSave(EntityInterface $entity, $update) { if ($update) { // If the password has been changed, delete all open sessions for the