/**
* Updates persistent objects using the query $query.
*
* The $query should be created using createUpdateQuery().
*
* Currently this method only executes the provided query. Future
* releases PersistentSession may introduce caching of persistent objects.
* When caching is introduced it will be required to use this method to run
* cusom delete queries. To avoid being incompatible with future releases it is
* advisable to always use this method when running custom delete queries on
* persistent objects.
*
* Attention: Every call to this method will cause the internal {@link
* ezcPersistentIdentityMap} to be completly reset. This is neccessary to
* avoid inconsistencies, because the session cannot trace which objects
* are updated by the query.
*
* @throws ezcPersistentQueryException
* if the update query failed.
*
* @param ezcQueryUpdate $query
*/
public function updateFromQuery(ezcQueryUpdate $query)
{
$this->identityMap->reset();
return $this->session->updateFromQuery($query);
}
