增加并完善模型生成表事件 (#684)

doc/dev/generate/table.md

@@ -28,14 +28,35 @@ vendor/bin/imi-xxx generate/table
 
 ## 事件监听
 
-### imi.generate_model.before
+在生成表时，会触发以下事件：
 
-生成表工具的前置操作
+- `Imi\Model\Cli\Table\Event\Param\BeforeGenerateTables` - 生成所有表前置事件
+- `Imi\Model\Cli\Table\Event\Param\AfterGenerateTables` - 生成所有表前置事件
+- `Imi\Model\Cli\Table\Event\Param\BeforeGenerateTable` - 生成表前置事件
+- `Imi\Model\Cli\Table\Event\Param\AfterGenerateTable` - 生成表前置事件
 
-**常量：** `Imi\Model\Cli\Table\Event\GenerateModelEvents::BEFORE_GENERATE_MODEL`
+> 事件参数类都是事件名本身
 
-### imi.generate_model.after
+`BeforeGenerateTable`、`AfterGenerateTable` 事件参数：
 
-生成表工具的后置操作
+```php
+/**
+ * 模型类名.
+ */
+public string $className,
 
-**常量：** `Imi\Model\Cli\Table\Event\GenerateModelEvents::AFTER_GENERATE_MODEL`
+/**
+ * 表名.
+ */
+public string $tableName,
+
+/**
+ * 是否跳过.
+ */
+public bool $skip,
+
+/**
+ * DDL 语句.
+ */
+public string $ddl,
+```

src/Components/model/src/Cli/Table/Event/Param/AfterGenerateTable.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Imi\Model\Cli\Table\Event\Param;
+
+use Imi\Event\CommonEvent;
+
+class AfterGenerateTable extends CommonEvent
+{
+    use TGenerateTable;
+}

src/Components/model/src/Cli/Table/Event/Param/AfterGenerateTables.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Imi\Model\Cli\Table\Event\Param;
+
+use Imi\Event\CommonEvent;
+
+class AfterGenerateTables extends CommonEvent
+{
+}

src/Components/model/src/Cli/Table/Event/Param/BeforeGenerateTable.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Imi\Model\Cli\Table\Event\Param;
+
+use Imi\Event\CommonEvent;
+
+class BeforeGenerateTable extends CommonEvent
+{
+    use TGenerateTable;
+}

src/Components/model/src/Cli/Table/Event/Param/BeforeGenerateTables.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Imi\Model\Cli\Table\Event\Param;
+
+use Imi\Event\CommonEvent;
+
+class BeforeGenerateTables extends CommonEvent
+{
+}

src/Components/model/src/Cli/Table/Event/Param/TGenerateTable.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Imi\Model\Cli\Table\Event\Param;
+
+trait TGenerateTable
+{
+    public function __construct(
+        /**
+         * 模型类名.
+         */
+        public string $className,
+
+        /**
+         * 表名.
+         */
+        public string $tableName,
+
+        /**
+         * 是否跳过.
+         */
+        public bool $skip,
+
+        /**
+         * DDL 语句.
+         */
+        public string $ddl,
+    ) {
+        parent::__construct(static::class);
+    }
+}

src/Components/model/src/Cli/Table/TableGenerate.php

@@ -12,7 +12,10 @@
 use Imi\Db\Db;
 use Imi\Event\Event;
 use Imi\Model\Annotation\DDL;
-use Imi\Model\Cli\Table\Event\GenerateModelEvents;
+use Imi\Model\Cli\Table\Event\Param\AfterGenerateTable;
+use Imi\Model\Cli\Table\Event\Param\AfterGenerateTables;
+use Imi\Model\Cli\Table\Event\Param\BeforeGenerateTable;
+use Imi\Model\Cli\Table\Event\Param\BeforeGenerateTables;
 use Imi\Util\ClassObject;
 
 #[Command(name: 'generate')]
@@ -31,7 +34,7 @@ class TableGenerate extends BaseCommand
     #[Option(name: 'override', type: \Imi\Cli\ArgType::STRING, default: false, comments: '是否覆盖已存在的表，请慎重！true-全覆盖;false-不覆盖;默认缺省状态为false')]
     public function generate(?string $namespace, ?string $database, ?string $poolName, array $include, array $exclude, string|bool $override): void
     {
-        Event::dispatch(eventName: GenerateModelEvents::BEFORE_GENERATE_MODEL);
+        Event::dispatch(eventName: BeforeGenerateTables::class);
         $override = (bool) json_decode((string) $override, false);
         // 数据库
         if (null === $database)
@@ -85,17 +88,23 @@ public function generate(?string $namespace, ?string $database, ?string $poolNam
                     $tables[] = $table;
                     // 表存在跳过
                     $this->output->writeln('Skip ' . $table);
+                    Event::dispatch(new BeforeGenerateTable($class, $table, true, ''));
+                    Event::dispatch(new AfterGenerateTable($class, $table, true, ''));
                     continue;
                 }
             }
             /** @var \Imi\Model\Annotation\DDL $ddlAnnotation */
             $ddlAnnotation = $point->getAnnotation();
+            $ddl = $ddlAnnotation->getRawSql() . ';';
+            $event = new BeforeGenerateTable($class, $table, false, $ddl);
+            Event::dispatch($event);
             // 创建表
-            Db::getInstance()->batchExec($ddlAnnotation->getRawSql() . ';');
+            Db::getInstance()->batchExec($event->ddl);
+            Event::dispatch(new AfterGenerateTable($class, $table, false, $ddl));
             $tables[] = $table;
             $this->output->writeln('Create <info>' . $table . '</info>');
         }
-        Event::dispatch(eventName: GenerateModelEvents::AFTER_GENERATE_MODEL);
+        Event::dispatch(eventName: AfterGenerateTables::class);
     }
 
     /**