1. interface
  2. Drupal
  3. \
  4. Core
  5. \
  6. Entity
  7. \
  8. Sql
  9. \
  10. SqlEntityStorageInterface

SqlEntityStorageInterface

interface SqlEntityStorageInterface implements EntityStorageInterface (View source)

A common interface for SQL-based entity storage implementations.

Methods

resetCache(array $ids = NULL)

Resets the internal entity cache.

from  EntityStorageInterface
EntityInterface[]
loadMultiple(array $ids = NULL)

Loads one or more entities.

from  EntityStorageInterface
EntityInterface|null
load(mixed $id)

Loads one entity.

from  EntityStorageInterface
EntityInterface|null
loadUnchanged(mixed $id)

Loads an unchanged entity from the database.

from  EntityStorageInterface
EntityInterface|null
loadRevision(int|string $revision_id)

Load a specific entity revision.

from  EntityStorageInterface
deleteRevision(int $revision_id)

Delete a specific entity revision.

from  EntityStorageInterface
EntityInterface[]
loadByProperties(array $values = [])

Load entities by their property values.

from  EntityStorageInterface
EntityInterface
create(array $values = [])

Constructs a new entity object, without permanently saving it.

from  EntityStorageInterface
delete(array $entities)

Deletes permanently saved entities.

from  EntityStorageInterface
SAVED_NEW
save(EntityInterface $entity)

Saves the entity permanently.

from  EntityStorageInterface
restore(EntityInterface $entity)

Restores a previously saved entity.

from  EntityStorageInterface
bool
hasData()

Determines if the storage contains any data.

from  EntityStorageInterface
QueryInterface
getQuery(string $conjunction = 'AND')

Gets an entity query instance.

from  EntityStorageInterface
QueryAggregateInterface
getAggregateQuery(string $conjunction = 'AND')

Gets an aggregated query instance.

from  EntityStorageInterface
string
getEntityTypeId()

Gets the entity type ID.

from  EntityStorageInterface
EntityTypeInterface
getEntityType()

Gets the entity type definition.

from  EntityStorageInterface
string
getEntityClass(string|null $bundle = NULL)

Retrieves the class name used to create the entity.

from  EntityStorageInterface
TableMappingInterface
getTableMapping(array $storage_definitions = NULL)

Gets a table mapping for the entity's SQL tables.

Details

in EntityStorageInterface at line 35
resetCache(array $ids = NULL)

Resets the internal entity cache.

Parameters

array $ids

(optional) If specified, the cache is reset for the entities with the given ids only.

in EntityStorageInterface at line 47
EntityInterface[] loadMultiple(array $ids = NULL)

Loads one or more entities.

Parameters

array $ids

An array of entity IDs, or NULL to load all entities.

Return Value

EntityInterface[]

An array of entity objects indexed by their IDs. Returns an empty array if no matching entities are found.

in EntityStorageInterface at line 58
EntityInterface|null load(mixed $id)

Loads one entity.

Parameters

mixed $id

The ID of the entity to load.

Return Value

EntityInterface|null

An entity object. NULL if no matching entity is found.

in EntityStorageInterface at line 72
EntityInterface|null loadUnchanged(mixed $id)

Loads an unchanged entity from the database.

Remove this method once we have a reliable way to retrieve the unchanged entity from the entity object.

Parameters

mixed $id

The ID of the entity to load.

Return Value

EntityInterface|null

The unchanged entity, or NULL if the entity cannot be loaded.

in EntityStorageInterface at line 89
EntityInterface|null loadRevision(int|string $revision_id)

Load a specific entity revision.

Deprecated in Drupal 8.5.0 and will be removed before Drupal 9.0.0. Use \Drupal\Core\Entity\RevisionableStorageInterface instead.

Parameters

int|string $revision_id

The revision id.

Return Value

EntityInterface|null

The specified entity revision or NULL if not found.

See also

https://www.drupal.org/node/2926958
https://www.drupal.org/node/2927226

in EntityStorageInterface at line 105
deleteRevision(int $revision_id)

Delete a specific entity revision.

A revision can only be deleted if it's not the currently active one.

Deprecated in Drupal 8.5.0 and will be removed before Drupal 9.0.0. Use \Drupal\Core\Entity\RevisionableStorageInterface instead.

Parameters

int $revision_id

The revision id.

See also

https://www.drupal.org/node/2926958
https://www.drupal.org/node/2927226

in EntityStorageInterface at line 117
EntityInterface[] loadByProperties(array $values = [])

Load entities by their property values.

Parameters

array $values

An associative array where the keys are the property names and the values are the values those properties must have.

Return Value

EntityInterface[]

An array of entity objects indexed by their ids.

in EntityStorageInterface at line 129
EntityInterface create(array $values = [])

Constructs a new entity object, without permanently saving it.

Parameters

array $values

(optional) An array of values to set, keyed by property name. If the entity type has bundles, the bundle key has to be specified.

Return Value

EntityInterface

A new entity object.

in EntityStorageInterface at line 140
delete(array $entities)

Deletes permanently saved entities.

Parameters

array $entities

An array of entity objects to delete.

Exceptions

EntityStorageException

in EntityStorageInterface at line 155
SAVED_NEW save(EntityInterface $entity)

Saves the entity permanently.

Parameters

EntityInterface $entity

The entity to save.

Return Value

SAVED_NEW

or SAVED_UPDATED is returned depending on the operation performed.

Exceptions

EntityStorageException

in EntityStorageInterface at line 177
restore(EntityInterface $entity)

internal  This method should never be used to perform a regular entity save. Its only use-case is to assist updating entity types when there are complex schema changes, for example, to make them revisionable. Note that overriding this method to fix data prior to restoring is a likely sign that the current data is corrupt.
 

Restores a previously saved entity.

Note that the entity is assumed to be in a valid state for the storage, so the restore process does not invoke any hooks, nor does it perform any pre or post-save operations.

Parameters

EntityInterface $entity

The entity to restore.

Exceptions

EntityStorageException

in EntityStorageInterface at line 185
bool hasData()

Determines if the storage contains any data.

Return Value

bool

TRUE if the storage contains data, FALSE if not.

in EntityStorageInterface at line 200
QueryInterface getQuery(string $conjunction = 'AND')

Gets an entity query instance.

Parameters

string $conjunction

(optional) The logical operator for the query, either:

  • AND: all of the conditions on the query need to match.
  • OR: at least one of the conditions on the query need to match.

Return Value

QueryInterface

The query instance.

See also

EntityStorageBase::getQueryServiceName

in EntityStorageInterface at line 215
QueryAggregateInterface getAggregateQuery(string $conjunction = 'AND')

Gets an aggregated query instance.

Parameters

string $conjunction

(optional) The logical operator for the query, either:

  • AND: all of the conditions on the query need to match.
  • OR: at least one of the conditions on the query need to match.

Return Value

QueryAggregateInterface

The aggregated query object that can query the given entity type.

See also

EntityStorageBase::getQueryServiceName

in EntityStorageInterface at line 223
string getEntityTypeId()

Gets the entity type ID.

Return Value

string

The entity type ID.

in EntityStorageInterface at line 231
EntityTypeInterface getEntityType()

Gets the entity type definition.

Return Value

EntityTypeInterface

Entity type definition.

in EntityStorageInterface at line 243
string getEntityClass(string|null $bundle = NULL)

Retrieves the class name used to create the entity.

Parameters

string|null $bundle

(optional) A specific entity type bundle identifier. Can be omitted in the case of entity types without bundles, like User.

Return Value

string

The entity class name.

at line 23
TableMappingInterface getTableMapping(array $storage_definitions = NULL)

Gets a table mapping for the entity's SQL tables.

Parameters

array $storage_definitions

(optional) An array of field storage definitions to be used to compute the table mapping. Defaults to the ones provided by the entity field manager.

Return Value

TableMappingInterface

A table mapping object for the entity's tables.