在 PHP 中實現(xiàn) DDD 用例

本文探討了 PHP 中的領(lǐng)域驅(qū)動設(shè)計 (DDD) 用例模型，演示了如何利用接口和特定于領(lǐng)域的類來管理數(shù)據(jù)持久性。我們將檢查 TaxPersistUseCase 類，它使用持久性管理器 (TaxManagerInterface) 來保存代表稅的 Tax 類型的實體。

該模型強調(diào) DDD 原則：每個組件都清晰地分為接口、具體實現(xiàn)和異常，遵循依賴注入和錯誤處理的最佳實踐。

TaxPersist用例的結(jié)構(gòu)

TaxPersistUseCase 類處理與持久稅收相關(guān)的業(yè)務(wù)邏輯。它分為幾個部分來闡明這種方法的邏輯和結(jié)構(gòu)。

依賴聲明

namespace Domain\Application\UseCase\Order;

use Domain\Application\Entity\Order\Tax;
use Domain\Application\Gateway\Manager\Order\TaxManagerInterface;
use Domain\Application\UseCase\Order\Exception\NotFoundException;
use Domain\Application\UseCase\Order\Interfaces\TaxPersistRequestInterface;
use Domain\Application\UseCase\Order\Interfaces\TaxPersistResponseInterface;
use Domain\Exception\BadRequestException;
use Domain\Exception\FormException;
use Small\CleanApplication\Contract\UseCaseInterface;
use Small\Collection\Collection\StringCollection;
use Small\SwooleEntityManager\EntityManager\Exception\EmptyResultException;

TaxPersistUseCase 類依賴于多個接口和異常來處理稅務(wù)持久性。以下是他們的角色細(xì)分：

TaxManagerInterface ：稅務(wù)持久性管理器的接口。

TaxPersistRequestInterface 和 TaxPersistResponseInterface ：用例請求和響應(yīng)的接口。
異常：各種異常，例如 BadRequestException、FormException 和 NotFoundException，有助于管理特定于上下文的錯誤。

TaxPersistUseCase 類的實現(xiàn)

namespace Domain\Application\UseCase\Order;

use Domain\Application\Entity\Order\Tax;
use Domain\Application\Gateway\Manager\Order\TaxManagerInterface;
use Domain\Application\UseCase\Order\Exception\NotFoundException;
use Domain\Application\UseCase\Order\Interfaces\TaxPersistRequestInterface;
use Domain\Application\UseCase\Order\Interfaces\TaxPersistResponseInterface;
use Domain\Exception\BadRequestException;
use Domain\Exception\FormException;
use Small\CleanApplication\Contract\UseCaseInterface;
use Small\Collection\Collection\StringCollection;
use Small\SwooleEntityManager\EntityManager\Exception\EmptyResultException;

• 構(gòu)造函數(shù)和依賴注入：構(gòu)造函數(shù)注入一個 TaxManagerInterface 實例，將 Tax 對象的持久性委托給該實例，而不將 TaxPersistUseCase 耦合到特定實現(xiàn)。
• 請求類型檢查：execute 方法驗證 $request 對象是否實現(xiàn)了 TaxPersistRequestInterface。這確保收到的請求符合預(yù)期的合同，提供接口級驗證。
• 持久化稅收對象：如果請求有效，則用例通過 getTax() 從 $request 中提取稅收對象，并調(diào)用 TaxManagerInterface 上的 applicationPersist 方法。這個持久化過程被封裝在一個try-catch塊中來處理潛在的異常
• EmptyResultException：如果未找到 Tax 實體，則會捕獲此異常并拋出 NotFoundException 來表示錯誤。
• FormException：如果表單驗證失敗，則會捕獲 FormException，并將錯誤消息存儲在 StringCollection 中。
• 通過匿名類的動態(tài)響應(yīng)：匿名類實現(xiàn) TaxPersistResponseInterface 以返回用例的響應(yīng)。它包括 getTax() 和 getMessages() 方法，分別允許訪問稅務(wù)實體和任何錯誤消息。

用例接口

接口定義了每個組件必須遵守的契約，促進(jìn)解耦和可測試性。

稅務(wù)管理界面

該接口指定了管理稅收的方法，包括檢索和持久化：

class TaxPersistUseCase implements UseCaseInterface
{

    public function __construct(
        protected TaxManagerInterface $taxManager,
    ) {}

    public function execute(mixed $request): TaxPersistResponseInterface
    {

        if (!$request instanceof TaxPersistRequestInterface) {
            throw new BadRequestException(
                self::class . ' accepts only request instance of ' . TaxPersistRequestInterface::class
            );
        }

        $tax = $request->getTax();
        $messages = new StringCollection();

        try {
            $this->taxManager->applicationPersist($tax);
        } catch (EmptyResultException $e) {
            throw new NotFoundException($e->getMessage());
        } catch (FormException $e) {
            $messages = $e->getFormMessages();
        }

        return new class($tax, $messages) implements TaxPersistResponseInterface
        {
            public function __construct(
                protected readonly Tax $tax,
                protected readonly StringCollection $messages,
            ) {}

            public function getTax(): Tax
            {
                return $this->tax;
            }

            public function getMessages(): StringCollection
            {
                return $this->messages;
            }
        };

    }

}

• findById() 和 findByName()：這些方法可以通過 ID 或名稱檢索稅款。
• applicationPersist()：此方法確保稅務(wù)實體的持久性。

TaxPersistRequest接口

該接口定義了 TaxPersistUseCase 所期望的請求的結(jié)構(gòu)：

interface TaxManagerInterface
{
    public function findById(int $id): Tax;
    public function findByName(string $name): Tax;
    public function applicationPersist(Tax $tax): self;
}

• getTax() ：該方法返回要持久保存的 Tax 實體，允許用例直接訪問相關(guān)領(lǐng)域?qū)ο蟆?TaxPersistResponse接口
• 響應(yīng)接口確保 TaxPersistUseCase 返回合規(guī)的響應(yīng)：

interface TaxPersistRequestInterface extends RequestInterface
{
    public function getTax(): Tax;
}

• getTax()：返回持久化的稅務(wù)實體，如果發(fā)生錯誤則返回 null。
• getMessages()：如果發(fā)生表單錯誤，則返回包含錯誤消息的 StringCollection。

錯誤和異常處理

異常通過捕獲特定于域的錯誤在 DDD 中發(fā)揮著重要作用：

• BadRequestException：如果用例收到錯誤類型的請求，則拋出。
• NotFoundException：當(dāng)找不到所尋求的稅務(wù)實體時拋出。
• FormException：捕獲以處理驗證錯誤，錯誤消息在 StringCollection 中返回。

以上是在 PHP 中實現(xiàn) DDD 用例的詳細(xì)內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！