失敗のレールへ移る分岐を切り替え線と呼びます。切り替え線の有無は、渡す関数が Err を返すかどうかで異なります。S04 の andThen に渡す ensureCheckedIn は Err を返すため線を持ち、map に渡す関数は Err を返さないため線を持ちません。
記録して返す工程の andThrough は、渡した関数が Ok を返すと、その値を捨てて元の値を次へ渡します。Err を返すと失敗のレールへ移ります。
-
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; });-
Ok(…)上のレール。成功の値が進む -
Err(…)下のレール。失敗の値が進む
S04 の診察開始のコードを、2本のレールに対応付けます。呼び出し 1 つが、レールの 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; });-
Ok(Appointment)予約が存在する。成功のレールから始まる -
Err(AppointmentNotFound)存在しない。失敗のレールから始まる
最初の ensureAppointmentFound は、Result を返します。存在すれば成功のレール、存在しなければ失敗のレールから始まります。
-
-
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; });-
Ok(CheckedIn)Ok(CheckedIn)ensureCheckedIn が ok を返す。成功のレールのまま -
Ok(Paid)Err(InvalidAppointmentState)ensureCheckedIn が err を返す。切り替え線で失敗のレールへ移る
andThen に渡す ensureCheckedIn は、ok か err を返します。err を返せるため、andThen は失敗のレールへ切り替えられる線です。
-
-
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; });-
Ok(CheckedIn)Ok(InExamination)成功のレールの上で、値を変えるだけ -
Err(…)Err(…)失敗のレールでは関数を呼ばず、そのまま通過する
map に渡す関数は、通常の値を返します。失敗を返せないため、切り替え線はありません。値を CheckedIn から InExamination に変えるだけです。
-
-
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; });-
Ok(InExamination)Ok(InExamination)保存してから同じ値を返す。レールは切り替わらない -
Err(…)Err(…)失敗のレールでは関数を呼ばず、そのまま通過する
最後の map は、保存の処理を行い、同じ値を返します。S04 は保存の接続断を障害として例外のままにするため、保存を Result を返さない map で行います。
-
-
examples/final/src/useCase/cancelAppointmentUseCase.ts:95-98 .andThen(ensureCancellable) .andThen(createEvent(dependencies, input)) .andThrough(dependencies.appointmentCanceledStore.store) .map((event) => ({ appointment: event.aggregateState }));-
Ok(Scheduled)Ok(…)andThen(createEvent): 結果を作る工程の関数(Ok の中身は省略)。Err を返さないため、切り替え線はない -
Ok(…)Ok(…)andThrough(store): 記録して返す工程の関数。Ok の値は捨てて、元の値が次へ渡る -
Ok(…)Err(AppointmentConflict)andThrough(store): 別のリクエストの先行更新(競合)の err で失敗のレールへ移る
記録して返す工程は andThrough です。保存は競合を Err で返せるため、切り替え線を持ちます。
-
-
examples/final/src/useCase/cancelAppointmentUseCase.ts:95-98 .andThen(ensureCancellable) .andThen(createEvent(dependencies, input)) .andThrough(dependencies.appointmentCanceledStore.store) .map((event) => ({ appointment: event.aggregateState }));-
andThen渡す関数が Err を返すときに切り替え線がある。Ok の値は次へ渡る -
andThrough渡す関数が Err を返すときに切り替え線がある。Ok の値は捨てて元の値が次へ渡る -
map切り替え線なし。渡す関数は通常の値を返す
切り替え線の有無は、渡す関数が Err を返すかどうかで異なります。前の工程が Err のときは、どの関数も呼びません。
-