課題1の1点目、失敗の理由が型に現れない点は、確認の関数と useCase の戻り値を Result にすることで解決します。andThen と map は、失敗する工程が増えても分岐を増やさないために使います。図で、工程ごとに2つの実装を比較します。
-
同じ4つの工程を、isErr で実装する場合と、andThen と map で実装する場合で比べます。失敗する工程は、予約を取得する工程と来院済みの確認の2つです。isErr で実装する場合にだけ、失敗を検証する分岐(斜線の部分)が 6 行あります。
isErr で実装する(説明用のコード)
andThen と map で実装する
-
工程1 予約を取得する: isErr の実装は、取得した直後に isErr で検証し、失敗の場合は返します。andThen と map の実装は、呼び出すだけです。失敗をそのまま次の処理へ返す動作は、後ろに続く andThen と map が担当します。
- 予約を取得する
- 来院済みの確認
- 状態の遷移
- 保存して返す
isErr で実装する 説明用のコードconst found = ensureAppointmentFound( deps.resolver.resolveById(input.appointmentId), input.appointmentId, ); if (found.isErr()) { return err(found.error); }andThen と map で実装する examples/session-04-solution/src/useCase/startExamination.tsensureAppointmentFound( deps.resolver.resolveById(input.appointmentId), input.appointmentId, ) -
工程2 来院済みの確認: isErr の実装は、isErr の分岐がもう1組必要です。andThen と map の実装は、andThen(ensureCheckedIn) の1行です。Err を受け取ったら、ensureCheckedIn を呼び出さずに、同じ Err を返します。
- 予約を取得する
- 来院済みの確認
- 状態の遷移
- 保存して返す
isErr で実装する 説明用のコードconst checkedIn = ensureCheckedIn(found.value); if (checkedIn.isErr()) { return err(checkedIn.error); }andThen と map で実装する examples/session-04-solution/src/useCase/startExamination.ts.andThen(ensureCheckedIn) -
工程3 状態の遷移: transitionToInExamination は失敗しない関数であるため、andThen と map の実装は map を使います。isErr の実装は、checkedIn.value を取り出して渡します。
- 予約を取得する
- 来院済みの確認
- 状態の遷移
- 保存して返す
isErr で実装する 説明用のコードconst next = transitionToInExamination( checkedIn.value, input.veterinarianId, input.examinationStartedAt, );andThen と map で実装する examples/session-04-solution/src/useCase/startExamination.ts.map((appointment) => transitionToInExamination( appointment, input.veterinarianId, input.examinationStartedAt, ), ) -
工程4 保存して返す: isErr の実装は、保存した後に ok(next) で包み直します。andThen と map の実装は、map の中で保存し、値を変更せずに返します。保存の障害を Result に含めない理由は、障害のページで説明します。ここでは Err を返さない処理であるため map を使います。
- 予約を取得する
- 来院済みの確認
- 状態の遷移
- 保存して返す
isErr で実装する 説明用のコードdeps.store.save(next); return ok(next);andThen と map で実装する examples/session-04-solution/src/useCase/startExamination.ts.map((appointment) => { deps.store.save(appointment); return appointment; });
全文を左右に並べて読む
説明用のコードconst startExamination =
(deps: Dependencies) =>
(input: StartExaminationInput): Result<
InExamination,
StartExaminationError
> => {
const found = ensureAppointmentFound(
deps.resolver.resolveById(input.appointmentId),
input.appointmentId,
);
if (found.isErr()) {
return err(found.error);
}
const checkedIn = ensureCheckedIn(found.value);
if (checkedIn.isErr()) {
return err(checkedIn.error);
}
const next = transitionToInExamination(
checkedIn.value,
input.veterinarianId,
input.examinationStartedAt,
);
deps.store.save(next);
return ok(next);
}; examples/session-04-solution/src/useCase/startExamination.ts:26-44export const startExamination =
(deps: Dependencies) =>
(input: StartExaminationInput): Result<InExamination, StartExaminationError> =>
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;
}); 解決したこと: 戻り値を Result にしたことで、失敗の理由が型に現れました。andThen と map によって、失敗する工程が増えても分岐は増えません。2点目は次のページで解決します。