ここまでに学んだ考え方には、広く使われている名前があります。次の図で、4つの名前が境界のどこを指すかを順に確認します。
外側
HTTP で受け取った値
unknown 境界
parse UUID の形かを検査する スマートコンストラクタ境界の検査 検査を通った値を返す Parse, don't validate境界の出口
内側
Always-Valid Domain Model内側全体 型付きの値
VeterinarianId Branded Type内側の型 業務の関数
startExamination -
スマートコンストラクタは、受け取った値を検査し、条件を満たす値だけをその型の値として作る関数です。
この教材では、Err を返す StartExaminationInput.parse がこれに当たり、外部入力の検査に使います。例外を投げる AppointmentId.parse は、正しいと分かっている値に使います。
-
Parse, don't validate は、検査の結果を true か false だけで返さず、検査を通った値を型付きの値として返す、という書き方の方針です。
検査のあとは、元の raw を使い続けず、返された型付きの値だけを使います。
-
Branded Type は、同じ string でも用途ごとにブランド(型を区別する情報)を付けて、別の型として区別する書き方です。
この教材では、AppointmentId と VeterinarianId がこれに当たります。
-
Always-Valid Domain Model は、予約や診察のような業務の概念と業務ルールを表す内側の型と関数を、検査を通った値だけを受け取る前提で作る設計です。
HTTP で受け取る入力は境界で検査済みであるため、内側の関数は同じ検査を繰り返しません。データベースの値は、アプリケーションが検査した値を保存している前提で、再度検査しません。ほかのシステムが書き込む場合は、読み取りの箇所も境界として扱います。
境界は役割の名前で、フォルダの名前ではありません。