在 PHP 中實(shí)作 DDD 用例

本文探討了 PHP 中的領(lǐng)域驅(qū)動設(shè)計(jì) (DDD) 用例模型，示範(fàn)如何利用介面和特定於領(lǐng)域的類別來管理資料持久性。我們將檢查 TaxPersistUseCase 類，它使用持久性管理器 (TaxManagerInterface) 來保存代表稅的 Tax 類型的實(shí)體。

此模型強(qiáng)調(diào) DDD 原則：每個(gè)元件都清晰地分為介面、具體實(shí)作和異常，遵循依賴注入和錯(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 ：用例請求和回應(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)函式與相依性注入：建構(gòu)函式註入一個(gè) TaxManagerInterface 實(shí)例，將 Tax 物件的持久性委託給該實(shí)例，而不將 TaxPersistUseCase 耦合到特定實(shí)作。
• 請求類型檢查：execute 方法驗(yàn)證 $request 物件是否實(shí)作了 TaxPersistRequestInterface。這確保收到的請求符合預(yù)期的合同，提供介面級驗(yàn)證。
• 持久化稅務(wù)對象：如果請求有效，則使用案例透過 getTax() 從 $request 中提取稅務(wù)對象，並呼叫 TaxManagerInterface 上的 applicationPersist 方法。這個(gè)持久化過程被封裝在一個(gè)try-catch區(qū)塊中來處理潛在的異常
• EmptyResultException：如果找不到 Tax 實(shí)體，則會捕獲此例外狀況並拋出 NotFoundException 來表示錯(cuò)誤。
• FormException：如果表單驗(yàn)證失敗，則會擷取 FormException，並將錯(cuò)誤訊息儲存在 StringCollection 中。
• 透過匿名類別的動態(tài)回應(yīng)：匿名類別實(shí)作 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 所期望的請求的結(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)域物件。 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ò)誤類型的請求，則拋出。
• NotFoundException：當(dāng)找不到所尋求的稅務(wù)實(shí)體時(shí)拋出。
• FormException：捕獲以處理驗(yàn)證錯(cuò)誤，錯(cuò)誤訊息在 StringCollection 中傳回。

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