ホーム 全セッション S04

失敗の種類ごとのお知らせの定義

10 / 19 目安 1分

ページ一覧

解決策(課題1の2点目): route が文言で判別する点を、失敗の種類ごとのお知らせの定義で解決します。

課題1の2点目、route が文言で判別する点は、失敗の種類(kind)で分岐することで解決します。useCase が kind を持つ失敗を Result で返すため、route は文言を検証せずに、kind ごとに画面のお知らせを定義できます。match は、Ok のときの処理と Err のときの処理を1か所にまとめて渡し、Result を画面の応答に変換する関数です。

  1. Result の match は、成功したときの処理と、失敗したときの処理を分けて渡します。失敗側は、kind を持つ失敗の値 error を受け取ります。

    Ok () => context.redirect("/", 303) 診察中の画面を開き直す
    Err(error は kind を持つ) (error) => context.redirect(…) お知らせを付けて画面を開き直す
    コード説明用のコード(route)
    return result.match(
      () => context.redirect("/", 303),
      (error) =>
        context.redirect(
          `/?notice=${toStartExaminationNoticeCode(error)}`,
          303,
        ),
    );
  2. 失敗の種類ごとに、お知らせのコードを対応表で定義します。AppointmentNotFound には "not-found" を対応させます。画面は、このコードから「予約が見つかりません」と表示します。

    失敗の種類

    お知らせのコード

    画面のお知らせ

    AppointmentNotFound "not-found" 予約が見つかりません InvalidAppointmentState "invalid-state" 現在の予約状態ではこの操作を実行できません
    コードexamples/session-04-solution/src/adaptor/primary/web/routes.ts:24-31
    type StartExaminationNoticeCode = "not-found" | "invalid-state";
    
    export const startExaminationNoticeCodes: Readonly<
      Record<StartExaminationError["kind"], StartExaminationNoticeCode>
    > = {
      AppointmentNotFound: "not-found",
      InvalidAppointmentState: "invalid-state",
    };
  3. InvalidAppointmentState には "invalid-state" を対応させます。画面は、このコードから「現在の予約状態ではこの操作を実行できません」と表示します。獣医師はこの文を読んで、現在の状態を確認します。

    失敗の種類

    お知らせのコード

    画面のお知らせ

    AppointmentNotFound "not-found" 予約が見つかりません InvalidAppointmentState "invalid-state" 現在の予約状態ではこの操作を実行できません
    コードexamples/session-04-solution/src/adaptor/primary/web/routes.ts:24-31
    type StartExaminationNoticeCode = "not-found" | "invalid-state";
    
    export const startExaminationNoticeCodes: Readonly<
      Record<StartExaminationError["kind"], StartExaminationNoticeCode>
    > = {
      AppointmentNotFound: "not-found",
      InvalidAppointmentState: "invalid-state",
    };
  4. match の失敗側は、switch で error.kind から、対応表のお知らせのコードを選び、redirect の ?notice= に含めます。失敗の種類が違えば、画面のお知らせも違います。

    失敗の種類

    お知らせのコード

    画面のお知らせ

    AppointmentNotFound "not-found" 予約が見つかりません InvalidAppointmentState "invalid-state" 現在の予約状態ではこの操作を実行できません
    コードexamples/session-04-solution/src/adaptor/primary/web/routes.ts:40-47
    switch (error.kind) {
      case "AppointmentNotFound":
        return startExaminationNoticeCodes.AppointmentNotFound;
      case "InvalidAppointmentState":
        return startExaminationNoticeCodes.InvalidAppointmentState;
      default:
        return assertNever(error);
    }

予約が見つからない失敗には「予約が見つかりません」を、状態不正には「現在の予約状態ではこの操作を実行できません」を表示します。獣医師は、前者の文を読んで予約を探し直し、後者の文を読んで予約の現在の状態を確認します。ここまでで、失敗の種類ごとに別々のお知らせを表示できます。