TYPO3扩展：如何实现符合精简控制器原则的关联对象创建？

嘿，作为TYPO3扩展开发的新手，你能意识到控制器要精简这点真的很棒！针对你这种多层级Object Storage自动创建的场景，咱们可以按照TYPO3的Domain Driven Design（DDD）思路来拆分代码，让每个类只负责自己的事儿，下面给你几个具体的实践方案：

1. 利用领域模型的构造函数或初始化方法 #

把创建子对象的逻辑放到对应的领域模型类里，让模型自己处理自身关联对象的初始化，控制器只需要负责顶层对象的创建与持久化即可。

示例代码：

// Classes/Domain/Model/TopLevel.php
class TopLevel extends AbstractEntity
{
    /**
     * @var ObjectStorage<MiddleLevel>
     */
    protected $middleLevels;

    public function __construct()
    {
        $this->middleLevels = new ObjectStorage();
        // 自动创建并添加一个默认的MiddleLevel对象
        $this->addMiddleLevel(new MiddleLevel());
    }

    public function addMiddleLevel(MiddleLevel $middleLevel): void
    {
        $this->middleLevels->attach($middleLevel);
    }
}

// Classes/Domain/Model/MiddleLevel.php
class MiddleLevel extends AbstractEntity
{
    /**
     * @var ObjectStorage<BottomLevel>
     */
    protected $bottomLevels;

    public function __construct()
    {
        $this->bottomLevels = new ObjectStorage();
        // 自动创建并添加一个默认的BottomLevel对象
        $this->addBottomLevel(new BottomLevel());
    }

    public function addBottomLevel(BottomLevel $bottomLevel): void
    {
        $this->bottomLevels->attach($bottomLevel);
    }
}

这时你的createAction会变得异常精简：

// Classes/Controller/TopLevelController.php
public function createAction(TopLevel $topLevel): void
{
    $this->topLevelRepository->add($topLevel);
    $this->addFlashMessage('记录创建成功！');
    $this->redirect('list');
}

2. 使用Repository的自定义方法 #

如果自动创建的逻辑需要结合业务规则（比如根据参数决定子对象的数量），可以把这些逻辑封装到Repository的自定义方法中，控制器调用该方法获取预先初始化好的实例。

示例：

// Classes/Domain/Repository/TopLevelRepository.php
class TopLevelRepository extends Repository
{
    public function createWithDefaults(int $middleCount = 1, int $bottomPerMiddle = 1): TopLevel
    {
        $topLevel = new TopLevel();
        // 根据业务规则创建对应数量的MiddleLevel对象
        for ($i = 0; $i < $middleCount; $i++) {
            $middleLevel = new MiddleLevel();
            // 给每个MiddleLevel添加对应数量的BottomLevel
            for ($j = 0; $j < $bottomPerMiddle; $j++) {
                $middleLevel->addBottomLevel(new BottomLevel());
            }
            $topLevel->addMiddleLevel($middleLevel);
        }
        return $topLevel;
    }
}

控制器中调用这个方法：

// Classes/Controller/TopLevelController.php
public function newAction(): void
{
    // 从Repository获取初始化好的实例，传递给视图
    $this->view->assign('topLevel', $this->topLevelRepository->createWithDefaults(2, 3));
}

public function createAction(TopLevel $topLevel): void
{
    $this->topLevelRepository->add($topLevel);
    // ... 后续跳转或提示逻辑
}

3. 利用TYPO3的事件系统解耦逻辑 #

如果初始化逻辑需要和其他扩展交互，或者不想让模型/Repository承担过多业务逻辑，可以使用TYPO3的事件系统，通过事件监听器来完成子对象的创建与关联。

首先定义事件类：

// Classes/Event/TopLevelCreatedEvent.php
class TopLevelCreatedEvent
{
    public function __construct(protected TopLevel $topLevel) {}

    public function getTopLevel(): TopLevel
    {
        return $this->topLevel;
    }
}

然后在控制器的createAction中触发事件：

// Classes/Controller/TopLevelController.php
use TYPO3\CMS\Core\EventDispatcher\EventDispatcher;

class TopLevelController extends ActionController
{
    public function __construct(protected EventDispatcher $eventDispatcher) {}

    public function createAction(TopLevel $topLevel): void
    {
        $this->topLevelRepository->add($topLevel);
        // 触发事件，交给监听器处理子对象创建
        $this->eventDispatcher->dispatch(new TopLevelCreatedEvent($topLevel));
        $this->addFlashMessage('记录创建成功！');
        $this->redirect('list');
    }
}

编写事件监听器：

// Classes/EventListener/TopLevelCreatedListener.php
class TopLevelCreatedListener
{
    public function __construct(protected TopLevelRepository $topLevelRepository) {}

    public function __invoke(TopLevelCreatedEvent $event): void
    {
        $topLevel = $event->getTopLevel();
        $middleLevel = new MiddleLevel();
        $middleLevel->addBottomLevel(new BottomLevel());
        $topLevel->addMiddleLevel($middleLevel);
        // 更新Repository以持久化关联变更
        $this->topLevelRepository->update($topLevel);
    }
}

最后在Services.yaml中注册监听器：

services:
  Vendor\Extension\EventListener\TopLevelCreatedListener:
    tags:
      - name: event.listener
        identifier: 'extension-top-level-created'
        event: Vendor\Extension\Event\TopLevelCreatedEvent

总结 #

• 简单的默认初始化逻辑，优先放到模型的构造函数里，最符合单一职责原则
• 带业务规则的初始化，放到Repository的自定义方法里，让控制器专注于请求处理
• 需要跨扩展交互或解耦的场景，用事件系统，让逻辑更加灵活

这样你的控制器就能保持精简，每个模块只负责自己的核心功能啦！

内容的提问来源于stack exchange，提问作者Mondblut