ダブルディスパッチの記事を更新しました
エンティティがドメインサービスに依存！？ダブルディスパッチとは？ のドキュメントを、このブランチで大幅に更新しました。
以前は概念の説明が中心だった記事を、図やコード例を交えた「読んで実装に活かせる」内容に仕上げ直しています。
ダブルディスパッチは「一時的な依存の逆転」という性質がポイントですが、文章だけだと通常の依存関係との違いが伝わりにくいと感じていました。
また、どの場面で採用すべきか・避けるべきかの判断基準や、具体的なコードがなかったため、学習用のアウトプットとしてはまだ不十分な状態でした。今回の更新で、そのあたりを補完しています。
主な更新内容
Section titled “主な更新内容”Mermaid 図の追加
Section titled “Mermaid 図の追加”次の図を新たに追加しました。
- ドメイン層の基本的な依存関係 — エンティティ、値オブジェクト、ドメインサービス、リポジトリ IF の関係を一覧化
- 通常の依存関係とダブルディスパッチ実行時の比較 — コード上の依存と、メソッド呼び出し時だけ生じる一時的な逆転を対比
- 問題のある実装とダブルディスパッチ実装の呼び出しフロー —
addMember/joinMember/verifyCanJoinを使った比較図
図が読みやすくなるよう、サイト側でも Mermaid の表示設定（フォントサイズや余白）と CSS を調整しています。
- 「一時的な依存の逆転」という表現を明確化し、恒久的な設計変更ではないことを強調
- ルール漏れが起きうる「基本的な依存関係」の問題点を、フローチャートで整理
- ダブルディスパッチによって「アプリケーションサービスが検証を忘れる」ミスを構造的に防げる理由を追記
使いどころの整理
Section titled “使いどころの整理”新セクション 「ダブルディスパッチを使用すべきケースと避けるべきケース」 を追加しました。
採用を検討したい場面（集約外の情報が必要、ルール漏れが致命的、など）と、無理に使わなくてよい場面（集約内で完結するルール、運用で十分な場合、など）を箇条書きでまとめています。
Kotlin による具体的なコード例
Section titled “Kotlin による具体的なコード例”「パーティーにプレイヤーを参加させる」という例で、次の 2 パターンを Kotlin で掲載しています。
- 問題のある実装 —
Party.addMemberが public のまま、検証をバイパスできてしまうケース - ダブルディスパッチの実装 —
joinMember内でPartyMembershipServiceを呼び、検証を必ず通すケース
ファクトリメソッド create からも同じ joinMember を経由する構成にし、生成・変更の両方でルールが適用されることを示しています。
実装時の注意点とまとめ
Section titled “実装時の注意点とまとめ”次のトピックを追記しました。
- 一時的な依存の逆転であることを忘れない
- ドメインサービスは状態を持たない
- 引数として渡すことで意図を明示する
- DB からの再構築（リハイドレーション）とは別問題
最後に、記事全体のポイントを 3 つに整理したまとめセクションも加えています。
今後について
Section titled “今後について”DDD まわりのドキュメントは、引き続き実務で使う知識を自分の言葉で整理しながら充実させていく予定です。
ダブルディスパッチの記事を読んで気づきやフィードバックがあれば、ぜひ教えてください。