パッケージ構成っていつでも悩ましい

Transcript

1. パッケージ構成っていつでも悩ましい Go Conference 2017 Autumn 2017/11/5 Future Architect Inc, Keigo Suda(@keigodasu)
2. ＊ エンジニア@FutureArchitect.Inc ＊ ⽇頃はKafka、Sparkとか⼤きなデータを扱うミドルウェアが専⾨ ＊ 「君のJava僕のJava」に疲れてGoを導⼊し始めた 須⽥桂伍 (すだ けいご) @keigodasu ※のちほど英訳版もアップしますm(_ _)m
3. 最初に結論 l パッケージ構成の⼤切なことはここに書いてある（まずはこれを読め） l そして話すことがなくなった。。。😇 ü パッケージ構成のパターン ü DDDライクなパッケージ構成実例 ü インタフェースによる実装 ü and more ...
4. パッケージを決めるための考慮ポイント l ⾒通しの良さ l 機能配置の視認性(どこに何があるか分かる,サイクルインポートさせない作り, ・・・) l テストのやりやすさ(テスト実⾏の単位, ・・・) l 再利⽤のしやすさ l 独⽴して利⽤できる機能 l internalパッケージの利⽤ l 詳細の隠蔽 l パッケージ間の連携はインタフェースで l あげればきりがない・・・
5. 規模の⼤きなシステムを作る時の選択肢は？🤔 l ライブラリ系/ミドルウェアはOSSを漁ればお⼿本はたくさんある l こんな感じで作ればいいなっていう勘所は⼗分つかめる l 規模の⼤きいシステムをGo未経験者も含むようなチーム(10⼈~)で作る際の お⼿本はあまりみかけない l GopherCon等含め意外とパッケージ構成のパターンに⾔及してるものは少ない l 本LTでは特にここについてどう考えるようにしているかお話します l インタフェース設計の話などテクニック的な話はないです🙇
6. ちまたの流儀？ l Golang Package Composition for Web Application: The Case of Mercari Kauru l https://speakerdeck.com/mercari/ja-golang-package-composition-for-web- application-the-case-of-mercari-kauru l Standard Package Layout l https://medium.com/@benbjohnson/standard-package-layout-7cdbc8391fc1 l Go and a Package Focused Design l https://medium.com/@benbjohnson/standard-package-layout-7cdbc8391fc1
7. でも現実は。。。😎 l DDDを意識としたパターンが多い気がする l Goとはいえオブジェクト指向的な考えも必要で、メンバ構成次第では機能配置等で維持 メンテ、レビュー⾟い時もある。 l そこそこ⼤きなシステムを経験者/未経験者混合チームで作る時はトランザク ションスクリプトの余地も残しておく必要あってまた悩ましい
8. どのように判断しているか(Goに限らず) l ⽐較的シンプル/未経験者も多い時はRailsライク(model/controller) l Pros) ちまたのノウハウを取り⼊れやすい/ある程度の同品質を保ちやすい(新規参画者が 馴染みやすい) l Cons) prosの裏返し。⼤きくなるにつれどんどんGoっぽさがなくなってくる感じがする l 経験者が多い時はDDDライク(厳密なDDDではなく・・・)に近づけてく l Pros) Goではみかける事が多く、その点では参考情報も得やすい l Cons) オブジェクト指向的な考え経験がないと維持つらい
9. 例）センサデータ受け付けるAPIサーバ l ~5⼈(Go経験1⼈/Java経験4⼈)ほどで開発した際のパッケージ構成 l Javaユーザへの導⼊としては意外とはまる（Goらしいかというと、、、） ・ ┗━━ data-uploader ┣━━ main.go ┣━━ api ┃ ┣━━handler.go ┃ ┗━━route.go ┣━━ controller ┃ ┣━━event.go ┃ ┗━━sensor.go ┣━━ service ←作らない時もある ┃ ┣━━ topic_routing.go ┃ ┗━━ ・・・ ┣━━ model ┃ ┣━━event.go ┃ ┗━━sensor.go ┗━━ util ┣━━ xxxutil ┃ ┗━━ ・・・ ┗━━ ・・・ https://www.slideshare.net/keigosuda/iot-72733494 ココのところ
10. ちなみにパッケージ名どう考える？🤔 GoPhoerCon 2017 - Go Anti-Patterns
11. ちなみにパッケージ名どう考える？🤔 l encodingパッケージなども例としてわかりやすい
12. ほんとすいません🙇🙇🙇🙇🙇🙇🙇🙇🙇 Golang UK Conference 2016 - Building an enterprise service in Go GoPhoerCon 2017 - Go Anti-Patterns l よく使われているのには理由がある？ l これぐらいのよくあるネーミングの⽅が未経験ユーザへの導⼊はしやすい？
13. まとめ l 新規導⼊時など、ときにはGoに⼊ればGoに従わない勇気も必要なシーンも 多々あった l もっとパッケージ構成の⽣々しいノウハウやパターンが発信されるといいのかも Golang UK 2016 keynote Dave Cheney
14. ありがとうございました!!