Go言語で作る webアプリ@gocon 2013 spring

Go言語で作る
Webアプリ
- RESTful APIを作ろう -

2013/4/13(Sat.)
@GoCon 2013 spring

自己紹介

上田拓也
新卒1年目

twitter : @tenntenn
blog: http://u.hinoichi.net

目標と対象

【目標】
● net/httpパッケージを知る
● gowebの基本的な使い方を知る

【対象】
● Go言語初心者
● goweb知らない人

アジェンダ

● Webサーバを作ろう
○ net/httpパッケージ
● RESTful APIを作ろう
○ RESTful APIとは？
○ gowebの使い方
● おまけ

はじめに

● ドキュメントを軽く見ながら聞いて下さい
○ http://golang.org/pkg/net/http
○ http://godoc.org/github.
com/stretchrcom/goweb/goweb

Go言語でhttpリクエストをハンドル

http.Server http.Handler
80番ポート
ListenAndServe ハンドル
@80ポート
ブラウザ

クライアントサイドサーバサイド

http.Server型
type Server struct {
Addr string
Handler Handler
ReadTimeout time.Duration
WriteTimeout time.Duration
MaxHeaderBytes int
TLSConfig *tls.Config
}

http.Server型

● type Server struct
○ func (srv *Server) ListenAndServe() error
○ func (srv *Server) ListenAndServeTLS(certFile,
keyFile string) error
○ func (srv *Server) Serve(l net.Listener) error

http.Handler型

type Handler interface {
ServeHTTP(ResponseWriter, *Request)
}

複数のハンドラを設定する

http.Handler

aa
/a
http.Handler
b
http.Server http.ServeMux /bb
ListenAndServe ハンドル
@80ポート /zzz
http.Handler

http.ServeMux型
type struct ServeMux{}
// 指定したパタンでハンドラを登録
func (mux *ServeMux) Handle(pattern string,
handler Handler)
// 指定したパタンでハンドラ関数を登録
func (mux *ServeMux) HandleFunc(pattern
string, handler func(ResponseWriter, *Request)
// http.Handlerの実装
func (mux *ServeMux) ServeHTTP(w
ResponseWriter, r *Request)

http.Handleの実装めんどい

● ServeMux.HandleFuncを使えばいい
● HandlerFuncを使って、関数にhttp.Handlerを
実装させている

http.HandlerFunc型

type HandlerFunc func(ResponseWriter,
*Request)

// src/pkg/net/http/server.goで実装
// http.Handlerを実装
func (f HandlerFunc) ServeHTTP(w
ResponseWriter, r *Request) {
f(w, r)
}

http.ServeMux作るのめんどい

● http.DefaultServeMuxというグローバル変数
がある
● http.Handleやhttp.HandleFuncはhttp.
DefaultServeMuxのメソッドのラッパー
● ハンドラが明示されないと、http.
DefaultServerMuxが使用される

簡単な例：hello, http!!

func main() {
f := func(w http.ResponseWriter, r *http.
Request) {
fmt.Fprintf(w, "hello, http!!")
}

http.HandleFunc("/", f)
http.ListenAndServe(":8080", nil)
}
https://github.com/golang-samples/http/tree/master/handlefunc

簡単な例：静的ファイル

func main() {

// static以下のファイルを提供
http.Handle("/", http.FileServer(http.Dir("static")))
http.ListenAndServe(":8080", nil)
}

https://github.com/golang-samples/http/tree/master/fileserv

RESTful APIとは？

● 明示的にHTTPメソッドを使う
○ POST, GET, PUT, DELETE
○ CRUDと対応
● ステートレスにする
○ 状態を保存しない
● ディレクトリ構造に似たURI
○ /api/persons/10
● XML、JSONなどを転送する
○ リクエストやレスポンスにXMLやJSONを使用

Go言語でRESTful APIを作る

● URIだけではなく、httpのメソッドでも分岐したい
● JSONやXMLで来たリクエストを簡単にオブジェ
クトにしたい
● JSONやXMLでレスポンスを返すのを簡単にし
たい

GoWebがあるよ！

GoWebってなに？

● RESTful APIを作るためのライブラリ
○ https://github.com/stretchrcom/goweb
● 細かいルーティング管理できる
● Controllerを作り、POST, GET, PUT, DELETE
などの単位でハンドリング
● JSONやXMLをリクエストから作れる
● レスポンスを簡単に作れる
○ 良く使うステータスコード
○ JSONやXML

GoWebの構造
DefaultRouteManager
:HttpHandler :RouteManager
:Controller

ServeHTTP GetMathingRoute()

routes

loop:routes
if:route.DoesMatchContext
route.Controller.HandleRequest()

GoWebの簡単な使い方
func main() {
handler := func(c *goweb.Context) {
name := c.PathParams["name"]
animal := c.PathParams["animal"]
fmt.Fprintf(c.ResponseWriter, "Hey %s,
your favorite animal is a %s", name, animal)
}
goweb.MapFunc("/people/{name}/animals/
{animal}", handler)
goweb.ListenAndServe(":8080")
}
https://github.com/golang-samples/goweb/tree/master/mapfunc

GoWebの簡単な使い方 RESTful API
// REST用のコントローラー
type MyController struct {}
HTTPメソッド URI例実装するメソッド
POST /api/ RestCreater.Create
GET /api/ RestManyReader.ReadMany
GET /api/123 RestReader.Read
PUT /api/ RestManyUpdater.UpdateMany
PUT /api/123 RestUpdater.Update
DELETE /api/ RestManyDeleter.DeleteMany
DELETE /api/123 RestDeleter.Delete
※必要なものだけ、実装する

// POSTをハンドリングする
func (cr *MyController) Create(cx
*goweb.Context) {
fmt.Fprintf(cx.ResponseWriter,
"Create new resource")
}

// GETをハンドリング（id指定）
func (cr *MyController) Read(id string, cx *goweb.
Context) {
fmt.Fprintf(cx.ResponseWriter, "Read
resource %s", id)
}

// GETをハンドリング（id指定なし）
func (cr *MyController) ReadMany(cx *goweb.
Context) {
fmt.Fprintf(cx.ResponseWriter, "Read many
resources")
}

// PUTをハンドリング（id指定）
func (cr *MyController) Update(id string, cx
*goweb.Context) {
fmt.Fprintf(cx.ResponseWriter, "Update
resource %s", id)
}

// PUTをハンドリング（id指定なし）
func (cr *MyController) UpdateMany(cx *goweb.
Context) {
fmt.Fprintf(cx.ResponseWriter, "Update
many resources")
}

// DELETEをハンドリング（id指定）
func (cr *MyController) Delete(id string, cx
*goweb.Context) {
fmt.Fprintf(cx.ResponseWriter, "Delete
resource %s", id)
}

// DELETEをハンドリング（id指定なし）
func (cr *MyController) DeleteMany(cx *goweb.
Context) {
fmt.Fprintf(cx.ResponseWriter, "Delete many
resources")
}

func main() {
controller := new(MyController)
goweb.MapRest("/api", controller)
goweb.ListenAndServe(":8080")
}

https://github.com/golang-samples/goweb/tree/master/rest

まとめ

● Go言語でWebサーバ作るの簡単！
○ net/httpパッケージを使う
● gowebを使えばRESTful API作るの簡単！
○ 各HTTPメソッドとURIに対応したメソッドを実装

話きれなかったこと

● テンプレートエンジン
○ html/template, text/template
● テスト
○ net/http/httptest
● FastCGI
○ net/http/fcgi
○ nginxなどで使用
● gowebの具体的な使用例
○ AngularJSから使う
○ https://github.com/golang-
samples/goweb/tree/master/diary

Go言語のサンプル置き場

● https://github.com/golang-samples
● みんなでサンプルを増やそう！
○ すでにあるパッケージはフォークしてもOK！
○ メンバーに加わって、新たにパッケージを追加しても
OK！

Go言語が使えるエディタ／IDE

● https://code.google.com/p/go-
wiki/wiki/IDEsAndTextEditorPlugin
s
● Vim
● Emacs
● Sublime Text
● LiteIDE
● Goclipse(Eclipse)
● Goworks(Netbeans)

ご清聴ありがとうございました

Go言語で作る webアプリ@gocon 2013 spring

Related slideshows

More Related Content

Go言語で作る webアプリ@gocon 2013 spring