ホーム 全セッション S05

切り替え線としての S04 の andThen

4 / 14 目安 1分

ページ一覧

事前知識: S04 で扱った andThen と map、S05 で使う andThrough が、2本のレールのどこに対応するかを確認します。

失敗のレールへ移る分岐を切り替え線と呼びます。切り替え線の有無は、渡す関数が Err を返すかどうかで異なります。S04 の andThen に渡す ensureCheckedIn は Err を返すため線を持ち、map に渡す関数は Err を返さないため線を持ちません。

記録して返す工程の andThrough は、渡した関数が Ok を返すと、その値を捨てて元の値を次へ渡します。Err を返すと失敗のレールへ移ります。

  1. examples/session-04-solution/src/useCase/startExamination.ts:29-44
    ensureAppointmentFound(
      deps.resolver.resolveById(input.appointmentId),
      input.appointmentId,
    )
      .andThen(ensureCheckedIn)
      .map((appointment) =>
        transitionToInExamination(
          appointment,
          input.veterinarianId,
          input.examinationStartedAt,
        ),
      )
      .map((appointment) => {
        deps.store.save(appointment);
        return appointment;
      });
    成功のレール 失敗のレール 切り替え線線なし線なし 入口 andThen map map
    • Ok(…) 上のレール。成功の値が進む
    • Err(…) 下のレール。失敗の値が進む

    S04 の診察開始のコードを、2本のレールに対応付けます。呼び出し 1 つが、レールの 1 区間に当たります。

  2. examples/session-04-solution/src/useCase/startExamination.ts:29-44
    ensureAppointmentFound(
      deps.resolver.resolveById(input.appointmentId),
      input.appointmentId,
    )
      .andThen(ensureCheckedIn)
      .map((appointment) =>
        transitionToInExamination(
          appointment,
          input.veterinarianId,
          input.examinationStartedAt,
        ),
      )
      .map((appointment) => {
        deps.store.save(appointment);
        return appointment;
      });
    成功のレール 失敗のレール 切り替え線線なし線なし 入口 andThen map map
    • Ok(Appointment) 予約が存在する。成功のレールから始まる
    • Err(AppointmentNotFound) 存在しない。失敗のレールから始まる

    最初の ensureAppointmentFound は、Result を返します。存在すれば成功のレール、存在しなければ失敗のレールから始まります。

  3. examples/session-04-solution/src/useCase/startExamination.ts:29-44
    ensureAppointmentFound(
      deps.resolver.resolveById(input.appointmentId),
      input.appointmentId,
    )
      .andThen(ensureCheckedIn)
      .map((appointment) =>
        transitionToInExamination(
          appointment,
          input.veterinarianId,
          input.examinationStartedAt,
        ),
      )
      .map((appointment) => {
        deps.store.save(appointment);
        return appointment;
      });
    成功のレール 失敗のレール 切り替え線線なし線なし 入口 andThen map map
    • Ok(CheckedIn) Ok(CheckedIn) ensureCheckedIn が ok を返す。成功のレールのまま
    • Ok(Paid) Err(InvalidAppointmentState) ensureCheckedIn が err を返す。切り替え線で失敗のレールへ移る

    andThen に渡す ensureCheckedIn は、ok か err を返します。err を返せるため、andThen は失敗のレールへ切り替えられる線です。

  4. examples/session-04-solution/src/useCase/startExamination.ts:29-44
    ensureAppointmentFound(
      deps.resolver.resolveById(input.appointmentId),
      input.appointmentId,
    )
      .andThen(ensureCheckedIn)
      .map((appointment) =>
        transitionToInExamination(
          appointment,
          input.veterinarianId,
          input.examinationStartedAt,
        ),
      )
      .map((appointment) => {
        deps.store.save(appointment);
        return appointment;
      });
    成功のレール 失敗のレール 切り替え線線なし線なし 入口 andThen map map
    • Ok(CheckedIn) Ok(InExamination) 成功のレールの上で、値を変えるだけ
    • Err(…) Err(…) 失敗のレールでは関数を呼ばず、そのまま通過する

    map に渡す関数は、通常の値を返します。失敗を返せないため、切り替え線はありません。値を CheckedIn から InExamination に変えるだけです。

  5. examples/session-04-solution/src/useCase/startExamination.ts:29-44
    ensureAppointmentFound(
      deps.resolver.resolveById(input.appointmentId),
      input.appointmentId,
    )
      .andThen(ensureCheckedIn)
      .map((appointment) =>
        transitionToInExamination(
          appointment,
          input.veterinarianId,
          input.examinationStartedAt,
        ),
      )
      .map((appointment) => {
        deps.store.save(appointment);
        return appointment;
      });
    成功のレール 失敗のレール 切り替え線線なし線なし 入口 andThen map map
    • Ok(InExamination) Ok(InExamination) 保存してから同じ値を返す。レールは切り替わらない
    • Err(…) Err(…) 失敗のレールでは関数を呼ばず、そのまま通過する

    最後の map は、保存の処理を行い、同じ値を返します。S04 は保存の接続断を障害として例外のままにするため、保存を Result を返さない map で行います。

  6. examples/final/src/useCase/cancelAppointmentUseCase.ts:95-98
    .andThen(ensureCancellable)
    .andThen(createEvent(dependencies, input))
    .andThrough(dependencies.appointmentCanceledStore.store)
    .map((event) => ({ appointment: event.aggregateState }));
    成功のレール 失敗のレール 切り替え線線なし切り替え線線なし andThen andThen andThrough map
    • Ok(Scheduled) Ok(…) andThen(createEvent): 結果を作る工程の関数(Ok の中身は省略)。Err を返さないため、切り替え線はない
    • Ok(…) Ok(…) andThrough(store): 記録して返す工程の関数。Ok の値は捨てて、元の値が次へ渡る
    • Ok(…) Err(AppointmentConflict) andThrough(store): 別のリクエストの先行更新(競合)の err で失敗のレールへ移る

    記録して返す工程は andThrough です。保存は競合を Err で返せるため、切り替え線を持ちます。

  7. examples/final/src/useCase/cancelAppointmentUseCase.ts:95-98
    .andThen(ensureCancellable)
    .andThen(createEvent(dependencies, input))
    .andThrough(dependencies.appointmentCanceledStore.store)
    .map((event) => ({ appointment: event.aggregateState }));
    成功のレール 失敗のレール 切り替え線線なし切り替え線線なし andThen andThen andThrough map
    • andThen 渡す関数が Err を返すときに切り替え線がある。Ok の値は次へ渡る
    • andThrough 渡す関数が Err を返すときに切り替え線がある。Ok の値は捨てて元の値が次へ渡る
    • map 切り替え線なし。渡す関数は通常の値を返す

    切り替え線の有無は、渡す関数が Err を返すかどうかで異なります。前の工程が Err のときは、どの関数も呼びません。