PHP での DDD ユースケースの実裝

この記事では、PHP のドメイン駆動設(shè)計 (DDD) ユースケース モデルを検討し、インターフェイスとドメイン固有のクラスを利用してデータの永続性を管理する方法を示します。 TaxPersistUseCase クラスを調(diào)べます。このクラスは永続化マネージャー (TaxManagerInterface) を使用して、稅金を表す Tax 型のエンティティを保存します。

このモデルは DDD 原則を強(qiáng)調(diào)しています。依存関係の挿入とエラー処理のベスト プラクティスに従って、各コンポーネントがインターフェイス、具體的な実裝、例外に明確に分離されています。

TaxPersistUseCase の構(gòu)造

TaxPersistUseCase クラスは、稅の永続化に関連するビジネス ロジックを処理します。このアプローチのロジックと構(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 クラスは、稅金の永続性を処理するためにいくつかのインターフェイスと例外に依存します。彼らの役割の內(nèi)訳は次のとおりです:

TaxManagerInterface : 稅金永続性マネージャーのインターフェイス。

TaxPersistRequestInterface および TaxPersistResponseInterface : ユースケースのリクエストとレスポンスのインターフェース。
例外: BadRequestException、FormException、NotFoundException などのさまざまな例外は、コンテキスト固有のエラーの管理に役立ちます。

TaxPersistUseCase クラスの実裝

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;

• コンストラクターと依存関係の注入: コンストラクターは TaxManagerInterface のインスタンスを注入し、TaxPersistUseCase を特定の実裝に結(jié)合することなく、Tax オブジェクトの永続性をこのインスタンスに委任します。
• リクエストタイプのチェック:execute メソッドは、$request オブジェクトが TaxPersistRequestInterface を?qū)g裝していることを検証します。これにより、受信したリクエストが期待されるコントラクトに準(zhǔn)拠していることが保証され、インターフェイスレベルの検証が提供されます。
• Tax オブジェクトの永続化: リクエストが有効な場合、ユースケースは getTax() を介して $request から Tax オブジェクトを抽出し、TaxManagerInterface の applicationPersist メソッドを呼び出します。この永続化プロセスは、潛在的な例外を処理するために try-catch ブロック內(nèi)にカプセル化されています
• EmptyResultException: Tax エンティティが見つからない場合、この例外が捕捉され、エラーを通知するために NotFoundException がスローされます。
• FormException: フォームの検証が失敗した場合、FormException がキャプチャされ、エラー メッセージが StringCollection に保存されます。
• 匿名クラスによる動的応答: 匿名クラスは、TaxPersistResponseInterface を?qū)g裝して、ユースケースの応答を返します。これには getTax() メソッドと getMessages() メソッドが含まれており、それぞれ Tax エンティティとエラー メッセージにアクセスできます。

ユースケースインターフェイス

インターフェイスは、各コンポーネントが遵守する必要がある規(guī)約を定義し、分離とテスト容易性を促進(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(): このメソッドは、Tax エンティティの永続性を保証します。

TaxPersistRequestInterface

このインターフェースは、TaxPersistUseCase によって予期されるリクエストの構(gòu)造を定義します:

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

• getTax() : このメソッドは永続化される Tax エンティティを返し、ユースケースが関連するドメイン オブジェクトに直接アクセスできるようにします。 TaxPersistResponseInterface
• 応答インターフェイスにより、TaxPersistUseCase が準(zhǔn)拠した応答を返すことが保証されます。

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

• getTax(): 永続化された Tax エンティティを返すか、エラーが発生した場合は null を返します。
• getMessages(): フォーム エラーが発生した場合は、エラー メッセージを含む StringCollection を返します。

エラーと例外の処理

例外は、ドメイン固有のエラーを捕捉することにより、DDD で重要な役割を果たします。

• BadRequestException: ユースケースが間違ったタイプのリクエストを受信した場合にスローされます。
• NotFoundException: 探した稅エンティティが見つからない場合にスローされます。
• FormException: 検証エラーを処理するためにキャッチされ、エラー メッセージが StringCollection で返されます。

以上がPHP での DDD ユースケースの実裝の詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。