connect-goとsqlboilerで構築するクリーンアーキテクチャ

「PIXIV DEV MEETUP 2024」LT発表資料
https://conference.pixiv.co.jp/2024/dev-meetup

Transcript

1. connect-goとsqlboilerで構築する クリーンアーキテクチャ hirocy
2. {広告なんでも, pixiv Ads}チーム エンジニア 💼 23新卒/広告開発 ❤ Go言語/VTuber https://x.com/hir0cy hirocy
3. 話すこと • クリーンアーキテクチャとは • connect-go・sqlboilerとは • 広告管理サーバーを設計した際の最終的なディレクトリ 構成の紹介 • connect-go・sqlboilerをクリーンアーキテクチャに取 り込む上での工夫
4. 話さないこと • connect-goとsqlboilerの使い方 • 基本的なクリーンアーキテクチャの実装 Ask the Speakerで僕と握手！
5. クリーンアーキテクチャ とは？
6. クリーンアーキテクチャ • Robert C. Martinが2012年に提唱したアーキテクチャ • 4層のレイヤー構造 ◦ Enterprise Business Rules(domain層) ◦ Application Business Rules(usecase層) ◦ Interface Adapters(interface層) ◦ Frameworks & Drivers(infrastructure層)
7. クリーンアーキテクチャ • Robert C. Martinが2012年に提唱したアーキテクチャ • 4層のレイヤー構造 ◦ Enterprise Business Rules(domain層) ◦ Application Business Rules(usecase層) ◦ Interface Adapters(interface層) ◦ Frameworks & Drivers(infrastructure層)
8. connect-go・sqlboiler とは？
9. connect-goの特徴 • The Go implementation of Connect: Protobuf RPC that works. • ConnectというプロトコルのGo実装 • Protobufで記述された通信の定義に基づいてGoのパッ ケージを生成
10. sqlboilerの特徴 • Generate a Go ORM tailored to your database schema. • 実際のDBスキーマからGoのORM(Object-Relational Mapping)をパッケージとして生成
11. どちらもパッケージ生成
12. クリーンアーキテクチャ のどこに生成？
13. 〜広告管理サーバーの場合〜 最終的なディレクトリ構成
14. 最終的なディレクトリ構成 "esakik/clean-architecture-python" (https://github.com/esakik/clean-architecture-python) より引用
15. 最終的なディレクトリ構成
16. なぜinterface層に生成？ • 例えばconnectについて... ◦ interface層 ▪ 通信の中身を見るレイヤー ◦ infrastructure層 ▪ 通信について記述するレイヤー →ハンドラーやDBのクエリをinterface層で記述したい
17. connect-go・sqlboiler を扱う上での工夫
18. sqlboilerを扱う上での工夫 • sqlboilerは独自の型とdomainとの変換が必要 ◦ converterを実装して対応 • sqlboilerの実行には*sql.DBが必要 ◦ infrastructure層で接続を張った*sql.DBを返すよう に実装
19. connect-goを扱う上での工夫 • 決められたHandlerの型 で実装する必要がある • interactorから presenterを呼ぶ流れと 相性が悪い "esakik/clean-architecture-python" (https://github.com/esakik/clean-architecture-python) より引用
20. connect-goを扱う上での工夫 controllerから presenterを呼び出す
21. connect-goを扱う上での工夫 controllerから presenterを呼び出す
22. connect-goを扱う上での工夫 "クリーンアーキテクチャの Presenter が分かりにくいのは MVC 2 じゃないから" (https://qiita.com/os1ma/items/c02af5b7783b58165c8d) より引用
23. まとめ • connect-goとsqlboilerはinterface層に生成 • presenterをcontrollerから呼び出すように改変 • 都度リファクタリングをすることでより良いアーキテク チャにしている • Goの互助会ブースやAsk the Speakerも是非！