SuperAPI AI 工具集

create-cqrs-bulk-commands

编程与开发

查看项目

更新于 10-16 07:09

技能介绍

本技能用于在 PrestaShop 中按照 CQRS 模式创建批量操作命令及其处理器,相关约定(AbstractBulkCommandHandler、BulkCommandExceptionInterface、失败后继续)参见 CQRS/CONTEXT.md。

一、用途 创建批量动作命令(Bulk Action Command)及其处理器,使实体支持批量删除与批量切换状态等操作。

二、主要能力

  1. 批量删除命令 在 src/Core/Domain/{Domain}/Command/BulkDelete{Domain}sCommand.php 中创建。构造函数接收 array $ids(scalar int[]);提供单一 getter:getIds(): array。

  2. 批量状态命令 在 src/Core/Domain/{Domain}/Command/BulkToggle{Domain}StatusCommand.php 中创建。构造函数接收 array $ids(int[])与 bool $expectedStatus;$expectedStatus = true 表示启用,false 表示禁用。Getters:getIds(): array 与 getExpectedStatus(): bool。

  3. 批量处理器 所有批量处理器结构一致,创建于 src/Adapter/{Domain}/CommandHandler/。批量删除处理器 BulkDelete{Domain}sHandler.php:对每个 ID 调用仓储的删除方法,收集失败项并继续处理剩余 ID。批量状态处理器 BulkToggle{Domain}StatusHandler.php:对每个 ID 加载实体,设置 active = $command->getExpectedStatus() 后更新;需使用命令中的目标状态,不要翻转当前值。

  4. 处理器接口 创建于 src/Core/Domain/{Domain}/CommandHandler/,包括 BulkDelete{Domain}sHandlerInterface 与 BulkToggle{Domain}StatusHandlerInterface,两者均返回 void。批量异常通过抛出而非返回方式传播。

三、使用方式 依据上述路径与命名规则创建命令类、处理器类与接口,处理器需继承 AbstractBulkCommandHandler 并遵循失败后继续的约定。

四、适用场景 为具有批量网格操作(bulk grid actions)的实体添加批量删除或批量状态切换能力。

五、限制 若实体没有批量网格操作,应完全跳过该技能。需与单实体命令在 ID 类型上保持一致。具体搜索关键字、标签及分类暂未提供。