iOS/Androidアプリへドメイン駆動設計（DDD）を導入してCleanArchitectureを目指す [導入編]

今回業務で初めてドメイン駆動設計（以後DDD）をiOSアプリへ導入してCleanArchitectureを目指してみたのでまとめとその所感をつらつらと書いてみます。
今回はたまたまiOSで導入したのでiOS前提で話を進めますがAndroidにも適用できる汎用的な概念です。
上辺だけの知識+オレオレルールで導入を始めたので間違っていたらご指摘お願いしますm(_ _)m

# そもそもドメイン駆動設計って？

MVCなどの概念と同じ（ちょっと違うけど）設計アーキテクチャの一つで、iOSやAndroidアプリ開発でおこりがちな、ファットコントローラーを解決することができる~~かもしれない~~設計手法の一つです。

## MVCじゃだめなん？

MVCを採用するiOSやAndroidアプリでは、コントローラクラス（UIViewControllerやActivity）の責務が非常に広く、クラスが肥大化しやすいという問題点があります
また画面単位でコントローラが生成されるため、画面ごとにロジックを書いてしまいがちです。
DDDではそれを止め、業務的関心事（ドメイン）を中心としたクラス設計を行います。
DDDではコントローラクラスはすべてViewと見なされ、UI操作のみに特化させます。

以下がDDDの概念図になります。

![8b186a93-ac69-0bd5-96f6-75c82ee958de.jpeg](https://qiita-image-store.s3.amazonaws.com/0/129872/5cc0a245-cbc6-9158-8b2b-3bdd9fa3bb3d.jpeg)

円の外側が外界（アプリケーションの外）で場合によってはUIだったりDBだったりクラウドだったりします。
外から中へはアクセスできるが中から外へはアクセスできない（知らなくていい）作りにします。

概念図の外周の青い部分では主に外界とのコミュニケーション機能を提供します。
外界の相手が人間だったらUIを変更したり、相手がDBだったらデータベースへのアクセス手段を提供し、API相手ならAPI通信を担うコードを実装します。

緑色の部分ではビジネスロジックとの仲介役を担います。
この部分が各種イベント（ボタンが押された等）のハンドリングを担います

赤の部分はUseCaseと呼ばれビジネスロジックを記述します。ここではどんなアプリケーションで動いているか、動いているのがiOSなのかAndroidなのか、データを取ってくるの先がデータベースなのかAPIなのかといった円の外側の事象は一切気にせず、業務関心事のみにフォーカスしてロジックのみを記述します。

中央の黄色い部分はモデルクラスです。ここには処理は記述せずUseCaseで使う入れ物（モデル）だけになります。JavaだとJavaBeanとかPOJOとか呼ばれたりしますね。

## なんとなく概念はわかったけどiOSアプリに導入するにはどうしたらいいねん

まずはクラス設計をしてみます。[この辺の記事](http://qiita.com/kayo_h/items/0f91fe8d1b66c8680ae6)を大いに参考にさせていただき、大きく以下の３つのレイヤーにわけました。

![DDD + MVVM(MVP) + DI で試行錯誤するCleanArchitecture.jpg](https://qiita-image-store.s3.amazonaws.com/0/129872/350a6331-eb4a-002b-a217-15b3bc8c0bf0.jpeg)

大きく3層に分けます。iOS開発的には最上位のフォルダ分けがこの3つになりますね
Presentation層とData層は概念図における外側になり、Domain層が円の内部になります
上層から下層へ向かって処理が流れ、Presentation層からData層を呼び出したり、処理を逆流したりはしません。

ちなみにこれを上の円の概念図に当てはめると以下のようになります
ここでは仮にAPI通信と内部DBへアクセスする機能があると仮定します。

![DDD + MVP(MVVM) + DI + Rxで試行錯誤するCleanArchitecture.jpg](https://qiita-image-store.s3.amazonaws.com/0/129872/add75c15-5ff9-d58e-7665-1a0630b47623.jpeg)

#### Presentation層
ここでは概念図における外側になり、MVPの概念も取り入れています。
UIの制御を行うViewとイベントのハンドリングを行うPresenterに分けます
1画面につき対応するViewController + Presenter（+ コールバックのためのDelegate）が基本でViewControllerで受け取ったイベントは基本的に全てPresenterへ流します。
その後場合によってはさらにDomain層のUseCaseへ処理を依頼したり、UIの更新を行うためにDelegateを通してViewControllerへ指示を出したりします。

![dcecea88-3892-d74c-b73d-df3c2f38b362.jpeg](https://qiita-image-store.s3.amazonaws.com/0/129872/71ada398-f181-5502-05a2-e9209b7f885b.jpeg)
※上記MVPモデルのModel部分がDDDにおけるDomain層、Data層のレイヤーになります

非同期処理を実装する場合はPresentation層→Domain層へ処理を依頼するタイミングで非同期へ移行し、その他のタイミングの非同期化は行いません。
後述しますが非同期化のための手段としては[RxSwift](https://github.com/ReactiveX/RxSwift)等のReactiveプログラミングで実現するとスマートだと思います

#### Domain層
ここは概念図における円の内側になります。
コアなビジネスロジックのみを担当し、iOSフレームワークには依存しない作りにします
iOSに依存しないのでUIKitなどは登場せず、純粋なSwiftのみで記述します
またPresentation層やData層も意識せず、画面単位の考え方もしません
（極端な言い方をすればPresentation層とData層をアプリからごっそり取り除いてもDomain層でエラーが発生しない）

#### Data層
この部分はまた概念図における外側になります。
主にUIに絡まない外界とのやり取りを担当します。大体はデータの入出力になりますね
どこからデータを取ってくるかなどはこの層に収めます。

## 依存関係を図にしてみるよ

上記の3つのレイヤーの依存関係は以下の通りです

![DDD + MVVM(MVP) + DI で試行錯誤するCleanArchitecture (1).jpg](https://qiita-image-store.s3.amazonaws.com/0/129872/03ea2752-2a3b-340d-2c3a-38700f311473.jpeg)

後述しますがレイヤーを跨ぐ場合、上位レイヤーはDIライブラリを用いて下位レイヤーのインターフェース（Protocol）のみを知っている状態にします。

## 処理の流れを図にしてみるよ

処理の流れは先のレイヤーの上から下へ流れる形になります。
上層は下層のインタフェースをクラスのメンバー変数に保持しておきます。

![DDD + MVVM(MVP) + DI で試行錯誤するCleanArchitecture (2).jpg](https://qiita-image-store.s3.amazonaws.com/0/129872/a9b9dc33-c293-1a5a-c3c5-c8980277afb0.jpeg)

その際に注意する点としてはPresentation層の中で循環したりDomainからDomainを呼び出したりしないようにします
概念図上の円の外側から入ってまっすぐ内側まで到達したらそのまま外側に出ていくイメージですね

この流れを実現する上でひとつ問題になることはDomain層とData層のやりとりにおいて処理の流れと依存関係が逆だということです。
依存されている方から依存している側を呼び出すことはできないので矛盾が生じていますが、これを解決する手段として[Dependency Injection](http://qiita.com/hshimo/items/1136087e1c6e5c5b0d9f)が存在します。
Swiftだと[Swinject](https://github.com/Swinject/Swinject)や[Typhoon](https://github.com/appsquickly/Typhoon)といったDIライブラリが存在するため、そういったライブラリを用いて外部から依存性を注入することで依存関係が逆転しても処理を投げることができます。Android(Java)なら[Dagger2](https://google.github.io/dagger/)が鉄板ですね。

DIライブラリをレイヤー間を跨ぐ場合に用いれば、インタフェース（Protocol）だけを知っている状態になるので、レイヤー同士の結合度を下げることが出来るため独立性、保守性が上がります。

仮に、ユーザーがデータ取得ボタンを押すことでAPIからデータを取得し、ローカルDBへ保存してその結果を画面に表示するという機能があった場合、流れは以下のようになります。

![DDD + MVP(MVVM) + DI + Rxで試行錯誤するCleanArchitecture (1).jpg](https://qiita-image-store.s3.amazonaws.com/0/129872/63b8687e-1a19-2163-113c-fb88144d9283.jpeg)

## Reactiveプログラミングをレイヤー間で使う

GUIアプリを開発する上でついて回るのが非同期処理です。
Domain層ではiOSフレームワークを意識しないのでもちろん今自分が行っている処理が同期処理なのか非同期処理なのかも気にしません。

そこで登場するのがReactiveプログラミングです。
[RxSwift](https://github.com/ReactiveX/RxSwift)等のReactive系ライブラリを用いてドメインからの戻り値をすべてObservableにすることで処理をどう扱うかをPresenterに任せることが出来ます。

![DDD + MVVM(MVP) + DI で試行錯誤するCleanArchitecture (3).jpg](https://qiita-image-store.s3.amazonaws.com/0/129872/bedf69f2-7e4b-33d9-3a45-3d5e980c7e7e.jpeg)

ReactiveプログラミングについてはDDDを実践する上で必須ではありませんが、使うとより(・∀・)ｲｲ!!感じになると思います。

## 実際のクラス構成にしてみた所

実際のXcode上のフォルダ構成は以下のようになりました。
正直、各レイヤー配下のフォルダ構成は必要に応じて追加していったので、明確なルールはなくプロダクトによって大きく変化すると思います。
私の開発アプリではこうなりましたという一例と捉えてもらえると幸いです

![スクリーンショット 2016-10-19 9.46.14.png](https://qiita-image-store.s3.amazonaws.com/0/129872/162ab8de-b81a-8ca9-32cd-a4021334f451.png)

また、この配下にもアプリ次第で多くのフォルダ構成が連なると思います。（この画像に見えているフォルダの配下にも実際たくさんフォルダはあります）

（AppDelegate.swiftは厳密にはPresentation層にいれるべきかも）

## あとは実装あるのみ

あとは実装あるのみなのですが、そもそもここまではDDDをiOSに導入するための枠組みでしか無いので、ドメイン駆動設計の思想に従って実装を進めます（雑）

「[どうなったか編](http://qiita.com/KazaKago/items/8a17d1604fee878ea880)」へ続きます。