Goの実装パターン ~ Webサーバ編 ~

1. の実装パターン ~ Webサーバ編 ~ golang.tokyo #9
2. 自己紹介 鈴木 大介 • Go歴は3年弱 • 2017年4月にDeNAに入社 • AndAppの開発をしています ◦ https://www.andapp.jp ◦ 技術面は golang.tokyo #6 のスライド参照 • 好きなエディタはVim
3. はじめに Webサーバの構成要素 1. サーバ ◦ http.Server 2. マルチプレクサ(ルータ) ◦ http.ServeMux 3. ハンドラ ◦ http.Handler, http.HandlerFunc 4. ミドルウェア ◦ panic処理やログ出力など色々 5. 外部インターフェース ◦ http.Client、 sql.DB、 など 今日は • ハンドラ • 外部インターフェース を実装する際のパターンを紹介します。
4. ハンドラ ハンドラ = HTTPのリクエストを受け付け、レスポンスを返す処理 主な実装パターン 1. 無名関数 2. ハンドラ関数 3. クロージャ 4. メソッド
5. 1. 無名関数 package main import ( "net/http" ) func main() { http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) { w.Write([]byte("hello, world!\n")) }) http.ListenAndServe(":8080", nil) }
6. ★ メリット ◦ すぐに処理を書くことができる ◦ 同一スコープの変数を使用することができる ★ デメリット ◦ 処理が長くなると見通しが悪くなる 軽い処理に向いている。 • ヘルスチェック • モック • など 1. 無名関数
7. 2. ハンドラ関数 package main import ( "net/http" ) func HelloHandler(w http.ResponseWriter, r *http.Request) { w.Write([]byte("hello, world!\n")) } func main() { http.HandleFunc("/", HelloHandler) http.ListenAndServe(":8080", nil) }
8. ★ メリット ◦ 処理を関数内に閉じることができる ★ デメリット ◦ 関数の外にあるデータとの接点が少ない もっともオーソドックスなスタイル。 迷ったらコレ。 2. ハンドラ関数
9. 3. クロージャ package main import ( "net/http" ) func HelloHandler() http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { w.Write([]byte("hello, world!\n")) } } func main() { http.HandleFunc("/", HelloHandler()) http.ListenAndServe(":8080", nil) }
10. 3. クロージャ ★ メリット ◦ 『ハンドラ関数』と同様、処理を関数内に閉じることができる ◦ 引数を通して外からデータを渡すことができる ★ デメリット ◦ 引数が増えすぎると面倒 AndAppではそこそこ使われているが、他ではあまり見ない? ※middlewareは除く goの内部では以下で使われている。 • net/http/pprofパッケージ func Handler(name string) http.Handler • go tool traceコマンド func serveSVGProfile(prof func(w io.Writer) error) http.HandlerFunc
11. 4. メソッド package main import ( "net/http" ) type handler struct{} func (h *handler) HelloHandler(w http.ResponseWriter, r *http.Request) { w.Write([]byte("hello, world!\n")) } func main() { h := &handler{} http.HandleFunc("/", h.HelloHandler) http.ListenAndServe(":8080", nil) }
12. 4. メソッド ★ メリット ◦ 処理をメソッド内に閉じることができる ◦ フィールドを通して外からデータを渡すことができる ◦ 複数のメソッドでフィールドを共有することができる ★ デメリット ◦ 事前に型の初期化する必要がある 規模の大きなサーバでよく見られるパターン。 • consul • docker • etcd • prometheus • upspin
13. 外部インターフェース 外部インターフェース = スコープに存在しないリソースへのアクセサ 主な実装パターン 1. パッケージ関数 2. グローバル変数 3. ローカル変数 4. DI
14. • 対象のパッケージをimportして公開されている関数を直接呼び出す • 必要なパラメータなどは全て呼び出す際に引数で設定する 高レベルな関数が用意されている or した場合に使われる。 ➔ ハンドラの実装パターンによらずに適用できる ➢ 細かい制御はしづらい ➢ 単体テストがやりにくくなることも... 1. パッケージ関数
15. 1. パッケージ関数 import ( "io" "net/http" ) func UserHandler(w http.ResponseWriter, r *http.Request) { res, _ := http.Get("http://localhost:8080/users/1") io.Copy(w, res.Body) }
16. • アクセサをトップレベルに宣言しておく • 初期化や設定などが必要であれば使用する前に行っておく 初期化した後に使い回すことができる場合に使われる。 ➔ ハンドラの実装パターンによらずに適用できる ➢ 規模が大きくなるにつれて管理が難しくなる 2. グローバル変数
17. 2. グローバル変数 import ( "database/sql" "fmt" "net/http" ) var DB *sql.DB func setupDB(driver, dsn string) error { var err error DB, err = sql.Open(driver, dsn) return err } func UserHandler(w http.ResponseWriter, r *http.Request) { var name string DB.QueryRow("SELECT name FROM user WHERE id = ?", 1).Scan(&name) fmt.Fprintf(w, "hello, %s\n", name) }
18. • 使用する毎に初期化を行い、処理を呼び出す 初期化にリクエスト時の情報が必要な場合に使われる。 ◦ Context ◦ パラメータ ◦ など ➔ ハンドラの実装パターンによらずに適用できる ➢ 初期化コストが高いとパフォーマンスへの影響が大きい ➢ 制御のしやすさは『パッケージ関数』とほぼ同じ 3. ローカル変数
19. 3. ローカル変数 import ( "fmt" "net" "net/http" ) func HelloUserHandler(w http.ResponseWriter, r *http.Request) { var dialer net.Dialer conn, _ := dialer.DialContext(r.Context(), "tcp", ":8000") buf := make([]byte, 32) conn.Read(buf) fmt.Fprintf(w, "hello, %s\n", buf) }
20. • 別の場所で用意したアクセサを使用するところに注入する アクセサのスコープを限定したり、使い分けをしたい時に使われる。 ➔ 規模が大きくなっても管理しやすく、単体テストも書きやすくなる ➢ ハンドラが適用可能なパターンで実装されている必要がある ▪ 『クロージャ』 ▪ 『メソッド』 4. DI
21. 4. DI(クロージャ) import ( "database/sql" "fmt" "net/http" ) func UserHandler(db *sql.DB) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { var name string db.QueryRow("SELECT name FROM user WHERE id = ?", 1).Scan(&name) fmt.Fprintf(w, "hello, %s\n", name) } }
22. 4. DI(メソッド) import ( "database/sql" "fmt" "net/http" ) type handler struct { db *sql.DB } func (h *handler) UserHandler(w http.ResponseWriter, r *http.Request) { var name string h.db.QueryRow("SELECT name FROM user WHERE id = ?", 1).Scan(&name) fmt.Fprintf(w, "hello, %s\n", name) }
23. おわりに Webサーバの基本的な実装パターンを紹介しましたが、ベストなパターンは • プロジェクト(何を作るのか、いつまでに作るのか) • チーム(誰が作るのか) によって変わってきます。 ❖ メリット・デメリットを踏まえて実装パターンを選択することが重要！