書籍『Clean Architecture　達人に学ぶソフトウェアの構造と設計』のまとめ

## 所感
ソフトウェアを「ソフト」に、柔軟性を保つためのアーキテクチャの考え方が書かれた本です。
いろんなところでも言われているように、[ボブおじさん](https://blog.tai2.net/the_clean_architecture.html)の元ネタ記事以上のことは書かれていません。
しかし、SOLID原則やコンポーネントの安定度などの解説があってからクリーンアーキテクチャの具体的な解説に入るので、元ネタの記事よりもすんなりと受け入れることができました。（ところどころの章にあるソフトウェア昔話も面白かったです。）

表紙にある「アーキテクチャのルールはどれも同じである」の『ルール』とは、「適切に境界線を引いて、方針が詳細に依存しないように作る」ということだと解釈しました。
オープン・クローズドの原則やコンポーネントの安定度を考慮して適切に境界線を引き、依存関係逆転の法則、リスコフの置換原則を適用して方針が詳細に依存しないようインターフェイスを設けることでソフトウェアをソフトな状態に保てます。

ただ、私自身Javaを書いた経験がないため、コンポーネントによるパッケージングといった話はいまいちピンと来ませんでした…。
また、フロント周り（*ViewがViewModelを見つける*方法など）への言及が少なめのため、実際どうやってJSフレームワークを使ってSPAを構築していくかは頭に浮かびづらいと感じました。この辺は[実際にやっている人](https://qiita.com/ttiger55/items/50d88e9dbf3039d7ab66)もいるので、別途参考にしていこうと思います。

## まとめ

### 第Ⅰ部
- ソフトウェアアーキテクチャの目的は、システム構築・運用に必要な人材コストを最小限に抑えるためである。
    - システムを急いでリリースすると、だんだんとコード一行あたりのコストも膨れ上がっていく。
    - 「急いでリリースして、あとでクリーンにする」ことなど不可能。
    - 実は**短期的にも**長期的にも、崩壊したコードを書く方が、クリーンなコードを書くより遅い。
        - TDDで開発したほうが10%早いというデータがある
- ソフトウェアには「ソフト =アーキテクチャ」と「ウェア =機能」という2つの価値がある。
    - どっちかが大事じゃなくて、どっちも大事。
    - アーキテクチャを後回しにしていると、変更困難なシステムになってしまう。

### 第Ⅱ部
- オブジェクト指向プログラミング（OO）
    - OO最大のメリットはポリモーフィズムである。
        - これまでは、制御の流れと依存の流れは一致していた。
        - インターフェイス経由で関数を呼び出せば、制御と依存の流れを反転することができる。
        - つまり、DBやUIをビジネスルールに依存させることができる。
        - すなわち、OOとは「ポリモーフィズムを使用することで、システムにあるすべてのソースコードの依存関係を絶対的に制御する能力」である。

### 第Ⅲ部 設計の原則

#### SOLID原則
- SOLID原則とは、関数やデータをどうクラスに組み込み、クラス同士をどう接続させるかの指針になる。
- SOLID原則は、以下の3つの特徴を持ったソフトウェア構造を作るという目的がある。
    - 変更に強いこと
    - 理解しやすいこと
    - コンポーネントの基盤として、多くのソフトウェアシステムで利用できること

#### SRP:単一責任の原則
- 「どのモジュールもたったひとつのことをやるべき」という原則**ではない**
- 正しくは、「モジュールを変更する理由はたった一つであるべき」
    - 変更理由は、ユーザーやアクターとも読み替えられる
    - つまり、「モジュールはたった一つのアクターに対して責務を負うべき」といえる
- データを関数から切り離すことで複数のアクターから責務を負っている問題を解決できる。
![](http://www.plantuml.com/plantuml/png/LOr12i9034NtEKMMkkWDN1HKS2dU84wpA6IQ8PCiYdXtRMd5MRx_7lo-Efb75d0jw8fFTTUCmsYSVDG980dLYdUQpoGfX5mDNu2ODkIlEXpXlPSt3NjmKTj3Ms6P_xDhBg8pyvhm1XToMfAVF7LTUzsevWjwdeR8yW40)

#### OCP:オープン・クローズドの原則
- 上位レベルのコンポーネントは下位レベルのコンポーネントが変更されても、変更する必要はない。
- コンポーネントAがコンポーネントBの変更から保護されるには、コンポーネントBをコンポーネントAに依存させる必要がある。

![](http://www.plantuml.com/plantuml/png/SoWkIImgAStDuIh9Br0eoLT8oYyfoSzLICaiIaqkoSpFu-9ApaaiBbPm1f6E2jLSjLnScNabgKLfYScf2kw99QdbYPKWOHI5JX0HcBIDRavgMeakr124S8sU7bGzbqDgNWhG6G00)

#### LSP:リスコフの置換原則
- 抽象型に依存しているコンポーネントは、抽象の派生型に依存しないこと。
    - 依存している抽象の、どの派生型でも動く。

![](http://www.plantuml.com/plantuml/png/NOqn4i90201xNi47aXTOPAmj_C99YCCC1yx1LUhV7OiRJKfsOLaYIyjU5T8Vc8utp_IAgpIc53S0qXA1Pr4Lk-CJtW1YoMqhn7WHOYF-uh5vvHPkHV_KQFGGuuZTqHXEa_AMqtZquwzvFZPtyfY5XMtjLJy0)

#### ISP:インターフェイス分離の原則
- 使用しない操作はインターフェイスに分離して、依存している箇所をなるべく減らすようにする。
- 必要ない依存を減らすことで、推移的な依存関係もなくすことができる。
    - `システムS→フレームワークF→データベースD`というアーキテクチャの場合、SはDにも推移的に依存している。
- User1がop2, op3にも依存している例
![Bad](http://www.plantuml.com/plantuml/png/SoWkIImgAStDuIh9Br0eoLT8oYyfoSzLICaiIaqkoSpFu-9ApaaiBbRmBoXMgEPIKCWlC0IJHc3IcAkMYmkc9BGujSWGgAWMYM-4nZS6yxb0fjdewaAqeF2CK7Z6N0wfUIb0vm40)

- 各操作がインターフェイスで分離された例
![Good](http://www.plantuml.com/plantuml/png/NT0n3eCm30NG_P_25s30NZjmWquv08LKGWAC4dTgkNiXgTeqYwMN7-TBwQBrmHxB3DEDJEccPhhGE0K_sAGhCCnzZ7JT8Zr1f5kR9gSfs85fDH_k_U39jSMrAk9Vn5KaEVe--AbqqOVsEDyBSsL9HYw-D4rUWkFI32Ub1KXydJut2_8_vIGwlux77xq1)

#### DIP:依存関係逆転の法則
- 「抽象だけに依存しているソースコードが、もっとも柔軟なシステムである」という考え
- 現実的にはすべてを抽象だけに依存するのは難しいので、「変化しやすい具象」にだけは依存しないように設計する。
    - 変化しやすい具象とは、開発中のモジュールや、頻繁に変更されるモジュールのこと
- コーディングプラクティスのまとめ
    - 変化しやすい具象クラスを参照しない。代わりにインターフェイスを参照する。
    - 変化しやすい具象クラスを継承しない。
    - 具象関数をオーバーライドしない。
    - 変化しやすい具象を名指しで参照しない。

### 第Ⅳ部 コンポーネントの原則
- どのクラスをどのコンポーネントに含めるか判断するための原則3つ
    - 再利用・リリース等価の原則（REP)
    - 閉鎖性共通の原則（CCP)
    - 全再利用の原則（CRP)
- REP・CCP（コンポーネントを大きくする）とCRP（コンポーネントを小さくする）は相反している。
    - どれを優先するかはプロジェクトの状況によって考えるべき。
    - 例えばプロジェクト初期ならREP(再利用性)よりもCCP(開発しやすさ）の方が重要視されやすい。

#### 再利用・リリース等価の原則（REP）
- 再利用の単位とリリースの単位は等価になる。
    - コンポーネントを再利用したくても、リリース番号がなければうまく再利用できない。
    - ひとつのコンポーネントを形成するクラスやモジュールは、同じバージョン・同じリリースプロセス・同じリリースドキュメントを持っていることが合理的である。

#### 閉鎖性共通の原則（CCP)
- 同じ理由、同じタイミングで変更されるクラスをコンポーネントにまとめること。変更の理由やタイミングが異なるクラスは、別のコンポーネントに分けること。
    - 同じタイミングで変更されることが多いクラスは、ひとつのコンポーネントにまとめておくこと。
    - 変更を1つのコンポーネント内に閉じ込める -> 閉鎖性（OCPの『クローズド』も同じ意味。）

#### 全再利用の原則（CRP)
- コンポーネントのユーザーに対して、実際には使わないものへの依存を強要してはいけない。
    - 一緒に用いられることが多いクラスやモジュールは同じコンポーネントにまとめよ、というもの。
    - 密結合していないクラスは同じコンポーネントにまとめない。まとめるクラスはどれも切り離せないものばかりにする。

---

- コンポーネントの関連を扱う原則3つ
    - 非循環依存関係の原則（ADP）
    - 安定依存の原則（SDP)
    - 安定度・抽象度等価の原則（SAP)

#### 非循環依存関係の原則（ADP)
- コンポーネントの依存グラフに循環依存があってはいけない。
- 依存性逆転の原則を用いて循環依存を解消することができる。

#### 安定依存の原則（SDP)
- 安定度の高い方向に依存すること。
- 安定度とは、コンポーネントの「変更しづらさ」のこと。以下のように計算できる。
    - ファン・イン…コンポーネントが依存**されている**外部コンポーネントの数
    - ファン・アウト…コンポーネントが依存**している**外部コンポーネントの数
    - `I`(Instability 不安定さ) = `ファン・アウト` / (`ファン・イン` + `ファン・アウト`)
        - 0 <= `I` <= 1
- SDPは、コンポーネントの`I`を依存するコンポーネントの`I`よりも大きくすべき（不安定にすべき）である。
- インターフェイスしかないコンポーネントは安定度が高いので、依存するのにちょうどよい。

#### 安定度・抽象度等価の原則(SAP)
- コンポーネントの抽象度は、その安定度の同程度でなければいけない。
    -  つまり、抽象度が高くなる方向に依存すべき。
-  抽象度は以下のように計算できる。
    -  Nc…コンポーネント内のクラス総数。
    -  Na…コンポーネント内の抽象クラスとインターフェイス総数。
    -  `A`（抽象度）= `Na` / `Nc`
        -  0 <= `A` <= 1
- 抽象度が低く、安定度が最高のコンポーネント(A=0, I=0)は、柔軟性にかけるので好ましくない。苦痛ゾーンと呼ばれている。
    - 変動性の低いコンポーネントは変更されることがないため、苦痛ゾーンにあっても問題ない。
- 抽象度が高く、安定度が低いコンポーネント(A=1, I=1)は、抽象化されているのに依存するコンポーネントが存在しない、無駄ゾーンである。
- コンポーネントにとっての理想的な場所は、抽象度が低く、安定度が低い場所(A=0, I=1)もしくは抽象度が高く、安定度が高い場所(A=1, I=0)である。
    - この2点を結ぶ直線を主系列と呼び、なるべくこの線に乗せるようにする。

### 第Ⅴ部 アーキテクチャ
- 優れたアーキテクチャは以下のことをサポートする必要がある。
    - システムのユースケース
        - 振る舞いを明らかにして、システムの意図を明確にすること。
        - 優れたアーキテクチャのショッピングカートシステムは、ショッピングカートに**見える**。
    - システムの運用
        - 顧客の増加に従ってシステムをスケールアップできること。
        - コンポーネント間通信を特定の技術基盤に依らない設計にすれば、簡単にスレッド→プロセス→サービスと移行できる。
    - システムの開発
        - チーム間で干渉しないように、コンポーネントを単独で開発できるようにする。
    - システムのデプロイ
        - 構成スクリプトや設定ファイルの変更に依存せずに「即時デプロイ」を目指す。
- ビジネスルールとそれ以外の間に境界線を引くことで、ビジネスロジック以外のアーキテクチャ決定を遅延することができる。
    - データベースを決める前に、ビジネスルールの作成とテストに集中することができる。
    - 遅延させた間でよりよいソリューションを検討することができる。
    - 境界線は変更理由が違うコンポーネント間に引く。
        - 例えばGUIの変更とビジネスルールの変更の理由は異なるはず。
        - 単一責任の原則（モジュールを変更する理由は、たった一つであるべき）に従えば境界線を引ける。
    - 具体的には、境界線をインターフェイスとして表現することで実装できる。
    - ![](http://www.plantuml.com/plantuml/png/SoWkIImgAStDuKhEIImkLWWjJarEB4vLgAxboimhIIrAIqnELN3AByrBIIog18f2bRaabYGc0TKv9YUd0hb0SIwOJXjTNRW6BhXEcngWCAekBgwy_99K1QN7ZPF1gEVfekRdKtkURv_rk775uyPLZniNFsvSzhYnvN5Jjv92Oh62do72F3qz4DVF4CX0DzOXDIy5w240)

#### レベル
- 下位レベルのコンポーネントが上位レベルのコンポーネントに依存すべきである。
- 入出力が近ければ近いほど、下位レベルに位置づけられる。

#### エンティティ
- ビジネスマネーを生み出すルールと、ルールに必要なデータをまとめたオブジェクトを「エンティティ」と呼ぶ。
    - クラスに限らず、ビジネスルールとビジネスデータをまとめたモジュールであればよい。
- ![](http://www.plantuml.com/plantuml/png/DSsn2W8n40JGFb-nfIB-mrM2S8M_CEG63IPxORCMX_ZlBYTsCm-6cOR3_DLgoXLZoBn2vPr4pjAjQ2wzScy6vuzfPLqYdgJXoHksHlN3SHVqNhUhEetZR_a1lNEE_OKC-wI9kiJb5m00)

#### ユースケース
- **アプリケーション固有**のビジネスルール(バリデーション等)、エンティティを呼び出す順番を記したオブジェクトを「ユースケース」と呼ぶ。
- 特定のユーザーインターフェースについては規定せず、渡されるデータ形式を規定する。
    - すなわち、ユースケースの入出力のデータは`HttpRequest`や`HttpResponse`等には**ならない**。
    - 入出力のデータに**エンティティを使わない**。「入出力データ形式」と「エンティティ」は変更する理由が異なるため。

#### クリーンアーキテクチャ
![](https://blog.cleancoder.com/uncle-bob/images/2012-08-13-the-clean-architecture/CleanArchitecture.jpg)
- クリーンアーキテクチャを採用したシステムの特徴
    - フレームワーク非依存
    - テスト可能
        - UI, データベース, Webサーバ等がなくてもビジネスルールをテストできる。
    - UI非依存
    - データベース非依存
    - 外部エージェント非依存
        - ビジネスルールは外界のインターフェイス（低レベルのコンポーネント）について何も知らない。
- 依存性のルール
    - ソースコードの依存性は高レベルのコンポーネントにのみ向かってなければいけない。
        - 図で言うところの「外側」から「内側」にのみ依存してよい。
- 各レイヤの責務
    - エンティティ
        - 外部で何が起きても変更されることがない。
    - ユースケース
        - UIやDBの変更がこのレイヤに影響を及ぼすことはない。
        - **アプリケーションの操作の変更**のみによって影響される。
    - インターフェイスアダプタ（図の`Controller`, `Presenter`, `Gateways`に該当する部分)
        - ユースケース・エンティティ ⇔ DB・Web等の外部エージェント間で、それぞれの利用しやすいデータ構造を変換する層。
            - ユースケース層とインターフェイスアダプタ層間は、単なるデータ構造である「モデル」でデータの受け渡しをする。
    - フレームワークとドライバ
            - フレームワークやデータベースと直接やり取りするコンポーネント。
- 境界線の越え方
    - 高レベルのコンポーネントから低レベルのコンポーネントへ通信するときは、依存関係逆転の原則を使って境界を超える。
    - 境界線を超えるデータは単なるデータ構造であるべき。エンティティや、データベースの行をそのまま渡すのは依存性のルールに違反する。

#### Humble Objectパターン
- あるコンポーネントの振る舞いを「テストしにくい振る舞い」と「テストしやすい振る舞い」に分離するためのデザインパターン。
    - テストしにくいふるまいは`Humble Object`としてなるべくシンプルにする。
- GUIの振る舞いを`Presenter`と`View`(Humble Object)に分ける。
    - `Presenter`はアプリケーションから受け取った値をロジックに沿って整形して、`View Model`(単なるデータ構造)に詰める。
    - `View`は`View Model`を見つけて、そのまま表示する。
    - ![](http://www.plantuml.com/plantuml/png/SoWkIImgAStDuKhEIImkLWWeIYrEpIj9BLAeheKAXMMcbllcfwJce0g1U5m8EHjTNOHcD74GZyiXDIy5Q0y0)