クリーンアーキテクチャの NodeJSによる実装例

Transcript

1. クリーンアーキテクチャの NodeJSによる実装例
2. 1. クリーンアーキテクチャ
3. クリーンアーキテクチャとは？ コントローラー - コントローラー - ミドルウェア - DTO リポジトリ - リポジトリ - UnitOfWork - DTO ユースケース（サービス） - ユースケース ドメイン - ドメインサービス - ドメインモデル - バリデーター - 便利関数 - 外部ライブラリのラッパー - 設定/環境変数オブジェクト DIP 下に 依存
4. コントローラーとは？ 1. リクエストからサービスが必要な情報を抽出 2. サービスが返す情報をレスポンスの形にする
5. コントローラーとは？ 取得系APIの例 (ts) DTOをドメインモデルに変換 ドメインモデルをDTOに変換 レスポンスでのみ必要な値などは このタイミングで生成する
6. コントローラーとは？ 更新系APIの例 (ts)
7. DTOとは？ 外部とのやり取りに使うパラメータなどの マッピング先オブジェクト
8. DTOとは？ DTOの例 (ts)
9. リポジトリとは？ 外部のサービス（DBやAPIなど）と データのやり取りをする
10. リポジトリとは？ リポジトリの例 (ts)
11. UnitOfWork（UoW）とは？ トランザクション処理をハンドリングする
12. UnitOfWork（UoW）とは？ UoWの例 (ts) 生成 UoWのファクトリ例 (ts)
13. UnitOfWork（UoW）とは？ UoWの使用例 (ts) UoWを生成 トランザクションの開始 トランザクションのコミット ロールバック
14. ユースケース（サービス）とは？ ドメインロジックやリポジトリなどがする処理の フローを制御する
15. ユースケース（サービス）とは？ リポジトリのインタフェースに依 存（DIP） ユースケースの例 (ts) リポジトリ ユースケース リポジトリの インタフェース
16. ドメインサービスとは？ ドメインモデルとして定義すると違和感のある ドメインロジックを処理する
17. ※ ドメインロジックとは？ サービス固有のロジック
18. ドメインサービスとは？ ドメインサービスの例 (ts)
19. ドメインモデルとは？ ドメインロジックを処理する
20. ドメインモデルとは？ ドメインモデルの例 (ts)
21. プリミティブ型のみに依存する関数 便利関数とは？
22. 便利関数とは？ 便利関数の例 (ts)
23. 外部ライブラリのラッパーとは？ 外部ライブラリのラッパー例 (ts) 処理の差し込みが可能
24. ※ 値オブジェクト 基本、値オブジェクトは使わない 必要になったら データの入れ替えがより大変になるので
25. ※ 値オブジェクト 値オブジェクトの例 (ts) :期間を表す
26. 2. アーキテクチャの評価
27. デメリットは？ • データの入れ替えが大変 • DIPが起こるところの書き方が冗長
28. デメリット: データの入れ替えが大変 例: APIリクエストパラメータ -> ドメインモデル 例: SQLレスポンス -> ドメインモデル
29. メリットは？ • ドメインロジックを再利用しやすい • ドメインロジックの記述箇所を特定するのが容易 • 変更箇所を最小限にできるため、改善しやすい • 処理が適切な粒度で分けられて、コードの見通しが良くなる • 実装をモックで置き換えられるので、テストが書きやすい
30. 3. その他、開発で気をつけていること
31. 開発の方針 • 関数にわかりやすい名前をつける わかりやすい関数名さえあればコメントは基本いらない • 適切な粒度で関数に切り出す 目安は、わかりやすい関数名がつけられる粒度 関数名だけで処理を書いて、後でその実装を書く • テストが書きやすいかを意識する • 何がドメインロジックかよく考える • ドメインロジックはできる限りドメインモデルに定義する そうしないと、再利用性の低いコードになる（ドメインモデル貧血症になる...）
32. 適切な粒度で関数に切り出すには？ こういう関数があったら良いな、 という気持ちで関数名で 処理の流れを書く 関数名に対応する実装を書く
33. テストが書きやすいかを意識するとはどういうことか • どういう粒度でテストしたいか 適切な粒度で処理を切り出し、名前をつけられる • 変数をここに定義して良いのか グローバル変数などを使うと、見えない情報によってテストしづらくなる • DIするのは何故か モックに置き換えて単体テストしやすくなる • 引数がオブジェクトで良いのか テストの時オブジェクト生成が面倒くさい、どの情報が本当に必要なのかわからなくなる • 分岐が沢山あった時困らないか 一つの関数に対するテストケースが増える
34. 最後に ベースとなるアーキテクチャを持ちつつも、 自分達のサービスに合わせて変えていく ベースとなるアーキテクチャが何もないと 何が良くて何が悪いかが分からず、改善しにくい