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

1. クリーンアーキテクチャ

クリーンアーキテクチャとは？コントローラー - コントローラー - ミドルウェア - DTO リポジトリ -
リポジトリ - UnitOfWork - DTO ユースケース（サービス） - ユースケースドメイン - ドメインサービス - ドメインモデル - バリデーター - 便利関数 - 外部ライブラリのラッパー - 設定/環境変数オブジェクト DIP 下に依存

コントローラーとは？ 1. リクエストからサービスが必要な情報を抽出 2. サービスが返す情報をレスポンスの形にする

コントローラーとは？取得系APIの例 (ts) DTOをドメインモデルに変換ドメインモデルをDTOに変換レスポンスでのみ必要な値などはこのタイミングで生成する

コントローラーとは？更新系APIの例 (ts)

DTOとは？外部とのやり取りに使うパラメータなどのマッピング先オブジェクト

DTOとは？ DTOの例 (ts)

リポジトリとは？外部のサービス（DBやAPIなど）とデータのやり取りをする

リポジトリとは？リポジトリの例 (ts)

UnitOfWork（UoW）とは？トランザクション処理をハンドリングする

UnitOfWork（UoW）とは？ UoWの例 (ts) 生成 UoWのファクトリ例 (ts)

UnitOfWork（UoW）とは？ UoWの使用例 (ts) UoWを生成トランザクションの開始トランザクションのコミットロールバック

ユースケース（サービス）とは？ドメインロジックやリポジトリなどがする処理のフローを制御する

ユースケース（サービス）とは？リポジトリのインタフェースに依存（DIP）ユースケースの例 (ts) リポジトリユースケースリポジトリのインタフェース

ドメインサービスとは？ドメインモデルとして定義すると違和感のあるドメインロジックを処理する

※ ドメインロジックとは？サービス固有のロジック

ドメインサービスとは？ドメインサービスの例 (ts)

ドメインモデルとは？ドメインロジックを処理する

ドメインモデルとは？ドメインモデルの例 (ts)

プリミティブ型のみに依存する関数便利関数とは？

便利関数とは？便利関数の例 (ts)

外部ライブラリのラッパーとは？外部ライブラリのラッパー例 (ts) 処理の差し込みが可能

※ 値オブジェクト基本、値オブジェクトは使わない必要になったらデータの入れ替えがより大変になるので

※ 値オブジェクト値オブジェクトの例 (ts) :期間を表す

2. アーキテクチャの評価

デメリットは？ • データの入れ替えが大変 • DIPが起こるところの書き方が冗長

デメリット: データの入れ替えが大変例: APIリクエストパラメータ -> ドメインモデル例: SQLレスポンス -> ドメインモデル

メリットは？ • ドメインロジックを再利用しやすい • ドメインロジックの記述箇所を特定するのが容易 • 変更箇所を最小限にできるため、改善しやすい • 処理が適切な粒度で分けられて、コードの見通しが良くなる •
実装をモックで置き換えられるので、テストが書きやすい

3. その他、開発で気をつけていること

開発の方針 • 関数にわかりやすい名前をつけるわかりやすい関数名さえあればコメントは基本いらない • 適切な粒度で関数に切り出す目安は、わかりやすい関数名がつけられる粒度関数名だけで処理を書いて、後でその実装を書く • テストが書きやすいかを意識する
• 何がドメインロジックかよく考える • ドメインロジックはできる限りドメインモデルに定義するそうしないと、再利用性の低いコードになる（ドメインモデル貧血症になる...）

適切な粒度で関数に切り出すには？こういう関数があったら良いな、という気持ちで関数名で処理の流れを書く関数名に対応する実装を書く

テストが書きやすいかを意識するとはどういうことか • どういう粒度でテストしたいか適切な粒度で処理を切り出し、名前をつけられる • 変数をここに定義して良いのかグローバル変数などを使うと、見えない情報によってテストしづらくなる • DIするのは何故かモックに置き換えて単体テストしやすくなる
• 引数がオブジェクトで良いのかテストの時オブジェクト生成が面倒くさい、どの情報が本当に必要なのかわからなくなる • 分岐が沢山あった時困らないか一つの関数に対するテストケースが増える

最後にベースとなるアーキテクチャを持ちつつも、自分達のサービスに合わせて変えていくベースとなるアーキテクチャが何もないと何が良くて何が悪いかが分からず、改善しにくい

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

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

Templiver

More Decks by Templiver

Other Decks in Programming

Featured

Transcript