ホーム 全セッション S03

学習した概念の名前

12 / 18 目安 0.5分

ページ一覧

解決策: ここまでに読んだ形の名前を知ると、担当業務で調査したり説明したりできます。

ここまでに学んだ考え方には、広く使われている名前があります。次の図で、4つの名前が境界のどこを指すかを順に確認します。

外側

HTTP で受け取った値 unknown

境界

parse UUID の形かを検査する スマートコンストラクタ境界の検査

内側

Always-Valid Domain Model内側全体
型付きの値 VeterinarianId Branded Type内側の型
業務の関数 startExamination
  1. スマートコンストラクタは、受け取った値を検査し、条件を満たす値だけをその型の値として作る関数です。

    この教材では、Err を返す StartExaminationInput.parse がこれに当たり、外部入力の検査に使います。例外を投げる AppointmentId.parse は、正しいと分かっている値に使います。

  2. Parse, don't validate は、検査の結果を true か false だけで返さず、検査を通った値を型付きの値として返す、という書き方の方針です。

    検査のあとは、元の raw を使い続けず、返された型付きの値だけを使います。

  3. Branded Type は、同じ string でも用途ごとにブランド(型を区別する情報)を付けて、別の型として区別する書き方です。

    この教材では、AppointmentId と VeterinarianId がこれに当たります。

  4. Always-Valid Domain Model は、予約や診察のような業務の概念と業務ルールを表す内側の型と関数を、検査を通った値だけを受け取る前提で作る設計です。

    HTTP で受け取る入力は境界で検査済みであるため、内側の関数は同じ検査を繰り返しません。データベースの値は、アプリケーションが検査した値を保存している前提で、再度検査しません。ほかのシステムが書き込む場合は、読み取りの箇所も境界として扱います。

境界は役割の名前で、フォルダの名前ではありません。