ホーム 全セッション S05

業務ロジックの外への I/O の配置

6 / 14 目安 0.75分

ページ一覧

解決策: データベースと時計を代替の実装に差し替えて、条件の検証をテストできるようにするために、I/O を業務ロジックの外に配置します。

課題2を解決するには、業務ロジックの外に I/O を配置します。I/O は、データベースの読み書きや現在時刻の取得のように、関数の外部とやり取りする処理です。業務ロジックは、結果を作る Appointment.cancel と、条件を判定する ensureCancellable です。Appointment.cancel は domain にあります。ensureCancellable は、S04 の ensureCheckedIn と同じく、1つの useCase だけが使う判定であるため useCase/ に置いています。「結果を作る」工程の createEvent(時刻と ID の取得)は I/O です。

副作用がなく、同じ入力から必ず同じ結果を返す関数を純粋関数と呼びます(S01 の説明)。ensureCancellable は予約の値だけで ok か err を返します。右は演習のコードの cancel で、予約、キャンセル理由、時刻の値だけで Canceled の予約を返します。

取得、保存、時刻の取得を、Resolver、Store、時計として引数で渡すため、テストでは代替の実装を useCase に渡して、条件の検証をデータベースなしで確認できます(演習の Paid のテスト)。ensureCancellable は純粋関数ですが、外部に公開していないため、直接は呼ばず useCase 経由でテストします。

参照実装の Appointment.cancel との差分

参照実装の Appointment.cancel は、petId と ownerId も保持し、次の2点も異なります。

  • 結果を Canceled の予約だけではなく、イベント AppointmentCanceled で包んで返します。
  • 時刻を引数の canceledAt ではなく、context(eventId、occurredAt、actorUserId をまとめた値)で受け取ります。createEvent が、時計と ID の生成器から取得して渡します。
examples/session-05-solution/src/domain/appointment/appointment.ts:39-50
export const cancel = (
  appointment: Scheduled | CheckedIn,
  cancellationReason: CancellationReason,
  canceledAt: Date,
): Canceled => ({
  kind: "Canceled",
  appointmentId: appointment.appointmentId,
  scheduledAt: appointment.scheduledAt,
  reason: appointment.reason,
  cancellationReason,
  canceledAt,
});