Make a REST Server on Golang

Transcript

1. GoでREST Serverを 作ってみました！ 2019.08.07 Kazuhisa Kawashima Renée French
2. 自己紹介：川嶋一寿 • 2019年6月ゆめみに入社（ゆめみは３社目） • フルリモート勤務（静岡） • Golangの経験 なし（仕事がありそうだからやってみる） • 好きな言語 Scala, TypeScript 参考：Shizuoka.jsでのLT資料
3. Agenda • 方針 • 開発環境 • システム構成 • 処理概要 • 感想 • Shizuoka.go
4. 方針
5. 方針 以下の方針でシステムを作成する • 基本パッケージのみを使用する(原則) • 実施に動作するシステムを作る • エラー処理も正しく書く • DIする
6. 開発環境
7. 使用言語 以下の2つを使用 • Go Language サーバ側で使用 • Vue / TypeScript クライアント側で使用
8. エディタ Visual Studio Codeを使用 いろいろなプラグインがあって便利 • Microsoft Remote Containers • Microsoft Go language support • Vetur • Microsoft Remote SSH • Microsoft Live Share
9. 動作環境 Mac版 Docker Desktopを使用 以下の3つのContainerを使用 • Web Server • Application Server • DB Server
10. システム構成
11. Docker システム構成 Webブラウザ Webサーバ Nginx アプリサーバ Golang DBサーバ PostgreSQL
12. Demo
13. 処理概要
14. 構成(モジュール) Main Controller Service <<interface>> Repository Repository PostgreSQL Message
15. 構成(DB) Word word_id id content create_date update_date id content create_date update_date reference_date Example
16. Main 各モジュールを用意し、クライアントからの受付を開始 する。 repo, err := repository.NewRepository(&config) service := service.DicService { Repo: repo } // コンストラクタインジェクション wc := controller.WordController { Service: service } router := mux.NewRouter() sub := router.PathPrefix("/word/").Subrouter() sub.HandleFunc("/histories", wc.GetHistories).Methods("GET") ・・・ http.Handle("/", router) http.ListenAndServe(":80", nil)
17. Router 各パスにControllerの関数を割り当てる router := mux.NewRouter() sub := router.PathPrefix("/word/").Subrouter() sub.HandleFunc("/histories", wc.GetHistories).Methods("GET") sub.HandleFunc("/", wc.AddWord).Methods("POST") sub.HandleFunc("/{id:[0-9]+}/example", wc.GetExamples).Methods("GET") sub.HandleFunc("/{id:[0-9]+}/example", wc.AddExample).Methods("POST") ※ gorillaを使用。net/httpでもルーティングの設定はできるが、メソッド やパスのパターンによる割り振りができない。
18. Gorillaとは • Webの処理で利用できるツールキット • RouterやSessionなど、Webに必要なモジュール がある • 利用するパッケージだけimportして使う 今回はRouterのみを利用
19. Controller 以下を行う • リクエストのパース • Serviceへの処理要求 • Serviceの処理結果の処理 実際のコードを見る ＞＞＞
20. Message type Word struct { Id int `json:"id"` Content string `json:"content"` CreateDate time.Time `json:"create_date"` UpdateDate time.Time `json:"update_date"` ReferenceDate time.Time `json:"reference_date"` } type Example struct { Id int `json:"id"` WordId int `json:"word_id"` Content string `json:"content"` CreateDate time.Time `json:"create_date"` UpdateDate time.Time `json:"update_date"` }
21. Service ビジネスロジック func (o *DicService) AddWordIfNotExist(word *Word) error { w, err := o.Repo.GetWord(word) if err != nil { return err } if w == nil { return o.Repo.AddWord(word) } else { return err } }
22. Repository 永続化を行うインターフェース type WordRepository interface { AddWord(word *Word) error GetWord(word *Word) (*Word, error) GetWords(order string, limit int) ([]Word, error) AddExample(example *Example) error GetExamples(word *Word) ([]Example, error) Close() }
23. Repository for postgresql PostgreSQLを使用するRepository 実際のコードを見る ＞＞＞
24. 感想
25. 苦労した点 • パッケージ名ってどうするの？ • ポッ ポインター ! • エラー処理はどうすればよい？
26. パッケージ名 importの使い方が、Javaと違う • package名とモジュールの保管先ディレクトリ名は 違って良い ※Javaは一致する必要あり • importには、package名ではなくモジュールを保管 したパス(GOPATHからの相対パス)を指定 ※Javaは、package名を指定 ※ここ見れば理解できる
27. ポインター • C言語と同様。 ただし、C言語のようにアドレスをずらすことはでき ない。 • 明示しなければ値渡しになる • ポインターを使用しないケース immutableにする場合(例:time.Time) https://yumemi.slack.com/archives/CHL24D4JY/p1562881539039800
28. エラー処理 • 関数の復帰値でerrorを返す • 下位のモジュールのエラーをラップする場合は、 golang/x/xerrorsを使う ↑の方法で呼び出し元はエラーの種別をどうやって判 断する？
29. xerrors func readFile(filename string) error { fp, err := os.Open(filename) if err != nil { return xerrors.Errorf("Can not open file.: %w", err) } defer fp.Close() reader := bufio.NewReaderSize(fp, 4096) for line := ""; err == nil; line, err = reader.ReadString('\n') { fmt.Print(line) } if err != io.EOF { return xerrors.Errorf("Can not read file: %w", err) } else { return nil } }
30. golangの良いところ • とっかかりやすい 言語仕様で理解すべきことが少ない • Googleが開発している GCPと相性良い？ • 起動が早い (対JVM言語) • Gopher君は好き クレジット表記のみで利用可能 Creative Commons Attributions 3.0 Renée French
31. Shizuoka.go
32. Shizuoka.goとは 静岡市で実施するgolangの勉強会 7/20に第14回目が実施済み 14回目の題目は以下 ・errors + log ・非同期処理 ・ライブラリやフレームワーク 参加人数は少なめ
33. Shizuoka.goの今後の活動 次回の開催は未定 だが、 Go 1.13のリリースを記念して、 8/22にGo 1.13 Release Party in shizuokaを開催 https://shizuoka-go.connpass.com/event/140162/
34. Thank you for listening! Renée French