1
0
mirror of synced 2024-12-17 00:18:42 +03:00
doctrine2/lib/Doctrine/ORM/Events.php

130 lines
4.3 KiB
PHP
Raw Normal View History

<?php
/*
* $Id$
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* This software consists of voluntary contributions made by many individuals
* and is licensed under the LGPL. For more information, see
* <http://www.doctrine-project.org>.
*/
namespace Doctrine\ORM;
/**
* Container for all ORM events.
*
* This class cannot be instantiated.
*
* @author Roman Borschel <roman@code-factory.org>
* @since 2.0
*/
final class Events
{
private function __construct() {}
2009-07-18 22:06:30 +04:00
/**
2009-07-24 15:33:38 +04:00
* The preRemove event occurs for a given entity before the respective
* EntityManager remove operation for that entity is executed.
2009-07-18 22:06:30 +04:00
*
* This is an entity lifecycle event.
*
* @var string
*/
2009-07-24 15:33:38 +04:00
const preRemove = 'preRemove';
2009-07-18 22:06:30 +04:00
/**
2009-07-24 15:33:38 +04:00
* The postRemove event occurs for an entity after the entity has
2009-07-18 22:06:30 +04:00
* been deleted. It will be invoked after the database delete operations.
*
* This is an entity lifecycle event.
*
* @var string
*/
2009-07-24 15:33:38 +04:00
const postRemove = 'postRemove';
2009-07-18 22:06:30 +04:00
/**
2009-07-24 15:33:38 +04:00
* The prePersist event occurs for a given entity before the respective
* EntityManager persist operation for that entity is executed.
2009-07-18 22:06:30 +04:00
*
* This is an entity lifecycle event.
*
* @var string
*/
2009-07-24 15:33:38 +04:00
const prePersist = 'prePersist';
2009-07-18 22:06:30 +04:00
/**
2009-07-24 15:33:38 +04:00
* The postPersist event occurs for an entity after the entity has
2009-07-18 22:06:30 +04:00
* been made persistent. It will be invoked after the database insert operations.
2009-07-24 15:33:38 +04:00
* Generated primary key values are available in the postPersist event.
2009-07-18 22:06:30 +04:00
*
* This is an entity lifecycle event.
*
* @var string
*/
2009-07-24 15:33:38 +04:00
const postPersist = 'postPersist';
2009-07-18 22:06:30 +04:00
/**
* The preUpdate event occurs before the database update operations to
* entity data.
*
* This is an entity lifecycle event.
*
* @var string
*/
const preUpdate = 'preUpdate';
2009-07-18 22:06:30 +04:00
/**
* The postUpdate event occurs after the database update operations to
* entity data.
*
* This is an entity lifecycle event.
*
* @var string
*/
const postUpdate = 'postUpdate';
2009-07-18 22:06:30 +04:00
/**
* The postLoad event occurs for an entity after the entity has been loaded
* into the current EntityManager from the database or after the refresh operation
* has been applied to it.
*
* Note that the postLoad event occurs for an entity before any associations have been
* initialized. Therefore it is not safe to access associations in a postLoad callback
* or event handler.
*
2009-07-18 22:06:30 +04:00
* This is an entity lifecycle event.
*
* @var string
*/
const postLoad = 'postLoad';
2009-07-18 22:06:30 +04:00
/**
* The loadClassMetadata event occurs after the mapping metadata for a class
* has been loaded from a mapping source (annotations/xml/yaml).
*
* @var string
*/
const loadClassMetadata = 'loadClassMetadata';
2010-02-24 22:19:04 +03:00
/**
* The onFlush event occurs when the EntityManager#flush() operation is invoked,
* after any changes to managed entities have been determined but before any
* actual database operations are executed. The event is only raised if there is
* actually something to do for the underlying UnitOfWork. If nothing needs to be done,
* the onFlush event is not raised.
*
* @var string
*/
const onFlush = 'onFlush';
2011-03-22 06:17:08 +03:00
/**
* The onClear event occurs when the EntityManager#clear() operation is invoked,
* after all references to entities have been removed from the unit of work.
*
* @var string
*/
const onClear = 'onClear';
}