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

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

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

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

TaxPersistUseCase 類處理與持久稅收相關(guān)的業(yè)務(wù)邏輯。它分為幾個(gè)部分來闡明這種方法的邏輯和結(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 類依賴于多個(gè)接口和異常來處理稅務(wù)持久性。以下是他們的角色細(xì)分：

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

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

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

用例接口

接口定義了每個(gè)組件必須遵守的契約，促進(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ù)實(shí)體的持久性。

TaxPersistRequest接口

該接口定義了 TaxPersistUseCase 所期望的請(qǐng)求的結(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 實(shí)體，允許用例直接訪問相關(guān)領(lǐng)域?qū)ο蟆?TaxPersistResponse接口
• 響應(yīng)接口確保 TaxPersistUseCase 返回合規(guī)的響應(yīng)：

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

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

錯(cuò)誤和異常處理

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

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

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