PHP 与DDD：如何确保只有Service才能调用实体上的方法？

Question

我正在使用域模型，其中有一个 Reservation 类：

class Reservation
{
    public function changeStatus($status) { ... }
}

因为 changeStatus() 方法只能在发送所有适当通知（电子邮件等）的上下文中调用我想将对这个方法的调用限制为 ReservationService：

class ReservationService
{
    public function confirmReservation(Reservation $reservation)
    {
        $reservation->changeStatus(Reservation::STATUS_CONFIRMED);
        // commit changes to the db, send notifications, etc.
    }
}

因为我正在使用 PHP，所以不存在诸如包可见性 或 友元类之类的概念，所以我的changeStatus() 方法是公共的，因此可以从应用程序中的任何位置调用。

我发现这个问题的唯一解决方案是使用某种双重调度：

class Reservation
{
    public function changeStatus(ReservationService $service)
    {
        $status = $service->getReservationStatus($this);
        $this->setStatus($status);
    }

    protected function setStatus($status) { ... }
}

潜在的缺点是：

• 这使设计有点复杂
• 这使得实体意识到服务，不确定这是否真的是是否有缺点

你们对上述解决方案有什么评论，或者有更好的设计来建议限制对此 changeStatus() 方法的访问吗？

Answer 1

使用强制执行您需要的上下文的接口：

interface INotifiable {
  public function updated( $reservation );
}

class Reservation {
  public function changeStatus( $status, INotifiable $notifiable ){
    $this->setStatus( $status );
    $notifiable->updated( $this );
  }
}

class EmailNotifier implements INotifiable {
  public function updated( $reservation ){
    $this->sendUpdateEmail( $reservation ); //or whatever
  }
}

预订不需要了解有关服务的任何信息。另一种方法是在 Reservation 上定义事件，但这会增加您可能不需要的复杂性。

Answer 2

您可以将消息从一个域实体发送到另一个域实体。只有能够生成某些消息的对象才会调用相关方法。下面是一个代码片段。此解决方案适用于依赖注入是一种宗教的项目，例如这里 PHP+DDD。

预订服务获得一个消息工厂。工厂是通过构造函数方法注入的。没有此工厂的对象无法发出此类消息。 （当然，您必须将对象实例化限制为工厂。）

class Domain_ReservationService
{

    private $changeStatusRequestFactory;

    public function __construct(
        Message_Factory_ChangeStatusRequest $changeStatusRequestFactory
    ) {
        $this->changeStatusRequestFactory = $changeStatusRequestFactory;
    }

    public function confirmReservation(Domain_Reservation $reservation) {

        $changeStatusRequest = $changeStatusRequestFactory->make(
            Reservation::STATUS_CONFIRMED
        );

        $reservation->changeStatus($changeStatusRequest);
        // commit changes to the db, send notifications, etc.

    }

}

Reservation 对象检查消息的内容并决定要做什么。

class Domain_Reservation
{

    public function changeStatus(
        Message_Item_ChangeStatusRequest $changeStatusRequest
    ) {
        $satus = $changeStatusRequest->getStatus();
        ...
    }

}

消息对象是一个 DDD 值对象。 （有时它的作用就像一种策略。）

class Message_Item_ChangeStatusRequest
{
    private $status;

    public function __construct( $status ) {
        $this->$status = $status;
    }

    public function getStatus() {
        return $this->$status;
    }

}

这个工厂生产消息​​。

class Message_Factory_ChangeStatusRequest
{

    public function make($status) {
        return new Message_Item_ChangeStatusRequest ($status);
    }

}

所有领域对象都是由该层工厂生成的。

class Domain_Factory
{

    public function makeReservationService() {
        return new Domain_ReservationService(
            new Message_Factory_ChangeStatusRequest()
        );
    }

    public function makeReservation() {
        return new Domain_Reservation();
    }

}

上面的类可以在您的应用程序中使用，如下所示。

$factory = new Domain_Factory();
$reservationService = $factory->makeReservationService();
$reservation = $factory->makeReservation();
$reservationService->confirmReservation($reservation);

但我不明白为什么您不想使用 $reservation->beConfirmed() 而不是传递状态常量。

Answer 3

实际上听起来这缺少一个非常重要的概念，即 ProcessManager。 ProcessManager 代表跨越多个上下文的分布式业务事务。实际上，它是一个简单的有限状态机。

示例工作流程：

1. 将 PlaceReservationCommand 发送到 ReservationContext，后者处理它并发布 ReservationWasPlacedEvent，ReservationProcessManager已订阅。
2. ReservationProcessManager 接收 ReservationWasPlacedEvent 并验证它是否可以转换到下一步。然后，我将 NotfiyCustomerAboutReservationCommand 发送到 NotificationContext。它现在侦听 ReservationNotificationFailedEvent 和 ReservationNotificationSucceededEvent。
3. 现在，仅当 ReservationProcessManager 收到 ReservationNotificationSucceededEvent 时，它才会将 ConfirmReservationCommand 发送到 ReservationContext。

这里的技巧是预订中没有状态字段。 ProcessManager 负责跟踪此业务事务的状态。最有可能的是一个 ReservationProcess 聚合，其中包含诸如 ReservationProcess::INITIATED 之类的状态，
ReservationProcess::CUSTOMER_NOTIFICATION_REQUESTED、ReservationProcess::CUSTOMER_NOTIFIED、ReservationProcess::CONFIRMATION_REQUESTED 和 ReservationProcess::CONFIRMED。最后一个状态表示有限状态，将流程标记为完成。

Answer 4

Symfony2 和 FLOW3 框架采用的其中一件事是使用 @api 注释注释来标记其稳定的公共 API。

虽然这并不完全是您正在寻找的，但它已经很接近了。它记录了用户可以依赖的 API 部分。另外，您的实体不必了解该服务，从而避免了邪恶的循环依赖。

示例：

class Request
{
    /**
     * Gets the Session.
     *
     * @return Session|null The session
     *
     * @api
     */
    public function getSession()
    {
        return $this->session;
    }
}