英語文法から学ぶ、クリーンな設計の秘訣

SOLID原則・凝集性・結合度・関心の分離・DDD・クリーンアキテクチャ...
設計を考える際、学ぶべき原理や手法が多すぎて圧倒されてしまうこともありますよね。

しかし、これら設計原則には、「英語の文法」にヒントが隠されているかも...?
英語文法の基本ルールに着目することで、設計原則を詳しく知らなくても、シンプルで明確な設計を行うための手がかりを得られるかもしれません！

このトークでは、SVO・SVOCなど基礎的な英語文法がどのようにコード設計に応用できるかを具体的に解説します。

- S(主語)やV(動詞)の明確化が単一責任原則の遵守に繋がること
- 「S(主語)がV(動詞)した」とクラス設計を考えることの恩恵
- コード上での形容詞・副詞の在り方
### 想定聴講者
- ソフトウェア設計に詳しくはないが興味を持っている方
- 設計の原理や手法が多くてなかなか手を出せずにいる方

Transcript

1. 英語文法から学ぶ、 クリーンな設計の 秘訣 P H P E R K A I G I 2 0 2 5 N O B L E N O M A D
2. THANK YOU ALL FOR TAKING THE TIME TO LISTEN MY SESSION TODAY.
3. I INTRODUCE MY SESSION FOR CLEAN CODE, BY ENGLISH.
4. 全部英語で発表した かったけど やっぱりきついので 日本語に 戻します
5. 自己紹介 • 名前 • NobleNomad • 職場 • 株式会社ウィルゲート 24卒 • 好きな言語・FW・ライブラリ • PHP, React • 趣味 • ゲーム制作・ドット絵制作
6. みなさん
7. 設計意識して ますか？
8. 設計原則 SOLID
9. 設計原則 SOLID 凝集性・結合度
10. 設計原則 SOLID 凝集性・結合度 関心の分離
11. 設計原則 SOLID 凝集性・結合度 関心の分離 DDD
12. 設計原則 SOLID 凝集性・結合度 関心の分離 DDD etc...
13. 設計原則 SOLID 凝集性・結合度 関心の分離 DDD etc... 覚えるべきことが 多すぎる！！
14. 設計原則 SOLID 凝集性・結合度 関心の分離 DDD etc... 覚えるべきことが 多すぎる！！ 結局どう活かせば いいの？
15. そこで
16. 話 す内 容 - 英 語 の 「 S VO 」 ル ー ル に 着 目 - 「 誰 が 何 を す る か 」 と い う 問 い に 徹 底 的 に 立 ち 返 る 。 - → 設 計 の 基 本 原 則 を 劇 的 に 実 現 で き る ！ SVOを意識すればきれいな設計ができる！
17. お こと わ り • あ く ま で 、 筆 者 が 試 し た ら う ま く 行 っ た 、 N = 1 の 経 験 則 で す • 例 外 ・ あ て は な ら な い ケ ー ス な ど も 想 定 さ れ ま す の で ご 了 承 く だ さ い 。 M (_ _ ) M – （ 思 想 が 強 め で す ）
18. な ぜ 「 英 語 文 法 」 な の か ？
19. な ぜ「 英 語文 法 」な の か？ 英語 • 原則「主語→動詞→目的語」 • 語順が明確 日本語 • 「が・を」など助詞で意味を 補完 • 解釈に幅が出る
20. な ぜ「 英 語文 法 」な の か？ 英語："The user saves the data." 日本語訳：『ユーザーがデータを保存する』 • 一目で「誰が」「何をする」のかが明確 – この明快さが、クラス設計にそのまま応用できる理由！ S V O
21. 実 践 例 S V O
22. 実 践 例 ユーザーがデータを保存する S V O
23. SVOの語順 O (Object：目的語) "the data"（データ） → 動詞の影響を受ける対象、処理の結果などを明示 V (Verb：動詞) "saves"（保存する） → 主語が実行する『何をするか』、クラスが持つ具体的な処理や責務 S (Subject：主語) "The user"（ユーザー） → 文章の中心となる『誰が』、クラスやエンティティそのもの
24. つまり • クラスやコードだけで「ユーザーがデータを保存する」と読める メリット1 • ドメイン知識を持たない人でも「これが何を意味するのか」が直感的に伝わる メリット2 一見で読みやすいコードになる！
25. さらに！
26. SVOを守ること で保守性が あがる！
27. 「 S V O 」 を 守 る と 何 が い い の か 関数→動詞 • 関心の分離が保た れる！ クラス →主語 • クラスの関心事が 明確→保守性向上
28. 関数→動詞 関数≠動詞 他オブジェクトのデータを操作するメソッド （Feature Envy）になってしまう 関数＝動詞として考える 自オブジェクトのデータを操作するメソッド になる 関数＝動詞として考える 責務が自然と適切クラスに集約される！ →関心の分離が保たれる！
29. 関数→動詞2 『良いコード/悪いコードで学ぶ設計入門』(通称ミノ駆動本)によると… ➢「動詞+目的語」関数は無責任な関数を追加しやすくなるこれを防ぐには 「動詞一語で済むようにクラス設計」をする。 ➢どうしても「動詞 + 目的語」になるのであれば、目的語の概念を表現する クラスを新しく作ること 関数は動詞一語で済むようにする →自然と関心事が明確になる！
30. クラス →主語 クラス名: Utility・Manager • 「とりあえず全部ここに書けばい いやろ」 • そして神クラスへ • クラス間依存が増大してしまいが ち クラス名: User • 「ユーザ「が ・に」できる操作」 のみ • 凝集性高、につながる
31. クラス →主語2 Userクラス • 「クライアント？運営？全部こ こに書けばいいやろ」 • そして神クラスへ • 4000行クラスなど、肥大化につ ながってしまう Clientクラス・ActiveUserクラス • クラスの肥大化を防げる！ • 関心事が明確→保守性向上 さらに言うと…… クラス名はある程度限定的にすると 関心事が明確→保守性向上！
32. まとめ
33. まとめ - 「 S VO 」 を 意 識 し た ク ラ ス 設 計 - コ ー ド が 読 み や す く な る - ク ラ ス の 関 心 事 が 明 確 に - 関 心 の 分 離 が 保 た れ る SVO文法は「誰が」「何をする」のかが 明確・かつ誰でも容易に理解できる明快なルール これをクラス設計に応用すると自然ときれいな設計ができる！