improve command move

- allow to delete some entities instead of moving them ;
- trigger event on move / delete entities in order to customize sql
statements

Actions/ActionEvent.php

@@ -0,0 +1,143 @@
+<?php
+/*
+ * Copyright (C) 2016-2019 Champs-Libres <info@champs-libres.coop>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+namespace Chill\PersonBundle\Actions;
+
+use Symfony\Component\EventDispatcher\Event;
+
+/**
+ * Event triggered when an entity attached to a person is removed.
+ * 
+ *
+ */
+class ActionEvent extends Event
+{
+    const DELETE = 'CHILL_PERSON.DELETE_ASSOCIATED_ENTITY';
+    const MOVE   = 'CHILL_PERSON.MOVE_ASSOCIATED_ENTITY';
+    
+    /**
+     *
+     * @var int
+     */
+    protected $personId;
+    
+    /**
+     * the FQDN class name as recorded in doctrine
+     *
+     * @var string
+     */
+    protected $entity;
+    
+    /**
+     * an array of key value data to describe the movement
+     *
+     * @var array
+     */
+    protected $metadata;
+    
+    /**
+     * the sql statement
+     *
+     * @var string 
+     */
+    protected $sqlStatement;
+    
+    /**
+     *
+     * @var string[]
+     */
+    protected $preSql = [];
+    
+    /**
+     *
+     * @var string[]
+     */
+    protected $postSql = [];
+    
+    public function __construct($personId, $entity, $sqlStatement, $metadata = [])
+    {
+        $this->personId = $personId;
+        $this->entity = $entity;
+        $this->sqlStatement = $sqlStatement;
+        $this->metadata = $metadata;
+    }
+
+    /**
+     * 
+     * @return string[]
+     */
+    public function getPreSql(): array
+    {
+        return $this->preSql;
+    }
+
+    /**
+     * 
+     * @return string[]
+     */
+    public function getPostSql(): array
+    {
+        return $this->postSql;
+    }
+
+    /*
+     * Add Sql which will be executed **before** the delete statement
+     */
+    public function addPreSql(string $preSql)
+    {
+        $this->preSql[] = $preSql;
+        return $this;
+    }
+
+    /**
+     * Add Sql which will be executed **after** the delete statement
+     * 
+     * @param type $postSql
+     * @return $this
+     */
+    public function addPostSql(string $postSql)
+    {
+        $this->postSql[] = $postSql;
+        return $this;
+    }
+
+    public function getPersonId(): int
+    {
+        return $this->personId;
+    }
+
+    /**
+     * get the entity name, as recorded in doctrine
+     * 
+     * @return string
+     */
+    public function getEntity(): string
+    {
+        return $this->entity;
+    }
+    
+    public function getSqlStatement()
+    {
+        return $this->sqlStatement;
+    }
+    
+    public function getMetadata()
+    {
+        return $this->metadata;
+    }
+    
+}

Actions/Remove/PersonMove.php

@@ -1,6 +1,6 @@
 <?php
 /*
- * Copyright (C) 20169 Champs-Libres <info@champs-libres.coop>
+ * Copyright (C) 2016-2019 Champs-Libres <info@champs-libres.coop>
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU Affero General Public License as published by
@@ -21,9 +21,16 @@ use Doctrine\ORM\EntityManagerInterface;
 use Chill\PersonBundle\Entity\Person;
 use Chill\PersonBundle\Entity\AccompanyingPeriod;
 use Doctrine\ORM\Mapping\ClassMetadata;
+use Symfony\Component\EventDispatcher\EventDispatcherInterface;
+use Chill\PersonBundle\Actions\ActionEvent;
 
 /**
- * Move all person to a new one, and delete the old record.
+ * Move or delete entities associated to a person to a new one, and delete the 
+ * old person. The data associated to a person (birthdate, name, ...) are left 
+ * untouched on the "new one".
+ * 
+ * See `getSql` for details.
+ * 
  *
  */
 class PersonMove
@@ -34,14 +41,51 @@ class PersonMove
      */
     protected $em;
     
-    public function __construct(EntityManagerInterface $em)
-    {
+    /**
+     *
+     * @var EventDispatcherInterface
+     */
+    protected $eventDispatcher;
+    
+    public function __construct(
+        EntityManagerInterface $em, 
+        EventDispatcherInterface $eventDispatcher
+    ) {
         $this->em = $em;
+        $this->eventDispatcher = $eventDispatcher;
     }
 
-    public function getSQL(Person $from, Person $to)
+    /**
+     * Return the sql used to move or delete entities associated to a person to 
+     * a new one, and delete the old person. The data associated to a person 
+     * (birthdate, name, ...) are left untouched on the "new one".
+     * 
+     * The accompanying periods associated to a person are always removed. The other 
+     * associated entity are updated: the new person id is associated to the entity.
+     * 
+     * Optionnaly, you can ask for removing entity by passing them in $deleteEntities
+     * parameters. 
+     * 
+     * The following events are triggered:
+     * - `'CHILL_PERSON.DELETE_ASSOCIATED_ENTITY'` is triggered when an entity
+     *     will be removed ;
+     * - `'CHILL_PERSON.MOVE_ASSOCIATED_ENTITY'` is triggered when an entity
+     *     will be moved ;
+     * 
+     * Those events have the following metadata:
+     * 
+     * - 'original_action' : always 'move' ;
+     * - 'to': the person id to move ;
+     * 
+     * @param Person $from
+     * @param Person $to
+     * @param array $deleteEntities
+     * @return type
+     */
+    public function getSQL(Person $from, Person $to, array $deleteEntities = [])
     {
         $sqls = [];
+        $toDelete = \array_merge($deleteEntities, $this->getDeleteEntities());
         
         foreach ($this->em->getMetadataFactory()->getAllMetadata() as $metadata) {
             if ($metadata->isMappedSuperclass) {
@@ -50,11 +94,21 @@ class PersonMove
             
             foreach ($metadata->getAssociationMappings() as $field => $mapping) {
                 if ($mapping['targetEntity'] === Person::class) {
-                    if (\in_array($metadata->getName(), $this->deleteEntities())) {
-                        $sqls[] = $this->createDeleteSQL($metadata, $from, $field);
+                    
+                    if (\in_array($metadata->getName(), $toDelete)) {
+                        $sql = $this->createDeleteSQL($metadata, $from, $field);
+                        $event = new ActionEvent($from->getId(), $metadata->getName(), $sql, 
+                            ['to' => $to->getId(), 'original_action' => 'move']);
+                        $this->eventDispatcher->dispatch(ActionEvent::DELETE, $event);
+                        
                     } else {
-                        $sqls[] = $this->createMoveSQL($metadata, $from, $to, $field);
+                        $sql = $this->createMoveSQL($metadata, $from, $to, $field);
+                        $event = new ActionEvent($from->getId(), $metadata->getName(), $sql, 
+                            ['to' => $to->getId(), 'original_action' => 'move']);
+                        $this->eventDispatcher->dispatch(ActionEvent::MOVE, $event);
                     }
+
+                    $sqls = \array_merge($sqls, $event->getPreSql(), [$event->getSqlStatement()], $event->getPostSql());
                 }
             }
         }
@@ -110,7 +164,7 @@ class PersonMove
      * 
      * @return array
      */
-    protected function deleteEntities(): array
+    protected function getDeleteEntities(): array
     {
         return [
             AccompanyingPeriod::class