Mercurial > hg > isophonics-drupal-site
diff core/modules/migrate/src/Event/MigrateEvents.php @ 0:4c8ae668cc8c
Initial import (non-working)
author | Chris Cannam |
---|---|
date | Wed, 29 Nov 2017 16:09:58 +0000 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/core/modules/migrate/src/Event/MigrateEvents.php Wed Nov 29 16:09:58 2017 +0000 @@ -0,0 +1,184 @@ +<?php + +namespace Drupal\migrate\Event; + +/** + * Defines events for the migration system. + * + * @see \Drupal\migrate\Event\MigrateMapSaveEvent + * @see \Drupal\migrate\Event\MigrateMapDeleteEvent + * @see \Drupal\migrate\Event\MigrateImportEvent + * @see \Drupal\migrate\Event\MigratePreRowSaveEvent + * @see \Drupal\migrate\Event\MigratePostRowSaveEvent + * @see \Drupal\migrate\Event\MigrateRollbackEvent + * @see \Drupal\migrate\Event\MigrateRowDeleteEvent + * @see \Drupal\migrate\Event\MigrateIdMapMessageEvent + */ +final class MigrateEvents { + + /** + * Name of the event fired when saving to a migration's map. + * + * This event allows modules to perform an action whenever the disposition of + * an item being migrated is saved to the map table. The event listener method + * receives a \Drupal\migrate\Event\MigrateMapSaveEvent instance. + * + * @Event + * + * @see \Drupal\migrate\Event\MigrateMapSaveEvent + * + * @var string + */ + const MAP_SAVE = 'migrate.map_save'; + + /** + * Name of the event fired when removing an entry from a migration's map. + * + * This event allows modules to perform an action whenever a row is deleted + * from a migration's map table (implying it has been rolled back). The event + * listener method receives a \Drupal\migrate\Event\MigrateMapDeleteEvent instance. + * + * @Event + * + * @see \Drupal\migrate\Event\MigrateMapDeleteEvent + * + * @var string + */ + const MAP_DELETE = 'migrate.map_delete'; + + /** + * Name of the event fired when beginning a migration import operation. + * + * This event allows modules to perform an action whenever a migration import + * operation is about to begin. The event listener method receives a + * \Drupal\migrate\Event\MigrateImportEvent instance. + * + * @Event + * + * @see \Drupal\migrate\Event\MigrateImportEvent + * + * @var string + */ + const PRE_IMPORT = 'migrate.pre_import'; + + /** + * Name of the event fired when finishing a migration import operation. + * + * This event allows modules to perform an action whenever a migration import + * operation is completing. The event listener method receives a + * \Drupal\migrate\Event\MigrateImportEvent instance. + * + * @Event + * + * @see \Drupal\migrate\Event\MigrateImportEvent + * + * @var string + */ + const POST_IMPORT = 'migrate.post_import'; + + /** + * Name of the event fired when about to import a single item. + * + * This event allows modules to perform an action whenever a specific item + * is about to be saved by the destination plugin. The event listener method + * receives a \Drupal\migrate\Event\MigratePreRowSaveEvent instance. + * + * @Event + * + * @see \Drupal\migrate\Event\MigratePreRowSaveEvent + * + * @var string + */ + const PRE_ROW_SAVE = 'migrate.pre_row_save'; + + /** + * Name of the event fired just after a single item has been imported. + * + * This event allows modules to perform an action whenever a specific item + * has been saved by the destination plugin. The event listener method + * receives a \Drupal\migrate\Event\MigratePostRowSaveEvent instance. + * + * @Event + * + * @see \Drupal\migrate\Event\MigratePostRowSaveEvent + * + * @var string + */ + const POST_ROW_SAVE = 'migrate.post_row_save'; + + /** + * Name of the event fired when beginning a migration rollback operation. + * + * This event allows modules to perform an action whenever a migration + * rollback operation is about to begin. The event listener method receives a + * \Drupal\migrate\Event\MigrateRollbackEvent instance. + * + * @Event + * + * @see \Drupal\migrate\Event\MigrateRollbackEvent + * + * @var string + */ + const PRE_ROLLBACK = 'migrate.pre_rollback'; + + /** + * Name of the event fired when finishing a migration rollback operation. + * + * This event allows modules to perform an action whenever a migration + * rollback operation is completing. The event listener method receives a + * \Drupal\migrate\Event\MigrateRollbackEvent instance. + * + * @Event + * + * @see \Drupal\migrate\Event\MigrateRollbackEvent + * + * @var string + */ + const POST_ROLLBACK = 'migrate.post_rollback'; + + /** + * Name of the event fired when about to delete a single item. + * + * This event allows modules to perform an action whenever a specific item + * is about to be deleted by the destination plugin. The event listener method + * receives a \Drupal\migrate\Event\MigrateRowDeleteEvent instance. + * + * @Event + * + * @see \Drupal\migrate\Event\MigrateRowDeleteEvent + * + * @var string + */ + const PRE_ROW_DELETE = 'migrate.pre_row_delete'; + + /** + * Name of the event fired just after a single item has been deleted. + * + * This event allows modules to perform an action whenever a specific item + * has been deleted by the destination plugin. The event listener method + * receives a \Drupal\migrate\Event\MigrateRowDeleteEvent instance. + * + * @Event + * + * @see \Drupal\migrate\Event\MigrateRowDeleteEvent + * + * @var string + */ + const POST_ROW_DELETE = 'migrate.post_row_delete'; + + /** + * Name of the event fired when saving a message to the idmap. + * + * This event allows modules to perform an action whenever a message is being + * logged by the idmap. The event listener method + * receives a \Drupal\migrate\Event\MigrateIdMapMessageEvent instance. + * + * @Event + * + * @see \Drupal\migrate\Event\MigrateIdMapMessageEvent + * + * @var string + */ + const IDMAP_MESSAGE = 'migrate.idmap_message'; + +}