net/http とは
net/http は、GoでWebアプリケーションを作るための標準ライブラリです。Goは標準ライブラリだけで本格的なWebサーバを立てられるのが特徴のひとつで、フレームワークを使わない状態でも十分に実用的です。まずは net/http の動きを理解することで、Gin などのフレームワークが何を薄くラップしているのかが見えるようになります。
1. 最小のWebサーバ
まずは、ポート 8080 で待ち受けて Hello, Go Web! を返すだけの最小のWebサーバを立ち上げます。以降の節では、この main.go をベースにハンドラの書き方・ルーティング・ミドルウェアを段階的に足していきます。
本章では、任意の場所に hello-http フォルダを作成し、Visual Studio Codeの「ファイル」→「フォルダーを開く」から、作成した hello-http フォルダを開きます。以降の操作は、Visual Studio Codeのターミナルから行います。
hello-http/ ← このフォルダを作成
main.go を作成します。Visual Studio Codeのエクスプローラーで hello-http フォルダを右クリックし、「新しいファイル」を選択して main.go という名前で作成してください。
hello-http/
└── main.go ← このファイルを作成
書き方は以下のとおりです。まず http.HandleFunc でパスとハンドラ関数の対応を登録します。
http.HandleFunc("パス", func(w http.ResponseWriter, r *http.Request) {
// レスポンス処理
})
第1引数は受け付けるURLパス、第2引数はそのパスに来たリクエストを処理するハンドラ関数です。ハンドラ関数とは、特定のパスへのリクエストに対して「どんなレスポンスを返すか」を書いた関数のことです。http.ResponseWriter(レスポンスの書き込み先)と *http.Request(受け取ったリクエスト)を引数に取ります。
続いて、http.ListenAndServe で指定ポートの待ち受けを開始します。
http.ListenAndServe(":ポート", nil)
第1引数は待ち受けるアドレスで、":ポート" の形式で指定します。第2引数はルーティング用の ServeMux です。nil を渡すと、Goが内部で持つデフォルトの ServeMux が使われ、先ほど http.HandleFunc で登録した内容がそのまま反映されます。
作成したファイルに以下の内容を記述して保存します。これは、ポート 8080 で待ち受けて、どんなパスへのアクセスに対しても Hello, Go Web! を返す最小のWebサーバです。
package main
import (
"fmt"
"net/http"
)
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "Hello, Go Web!")
})
fmt.Println("http://localhost:8080 で起動")
http.ListenAndServe(":8080", nil)
}
Visual Studio Codeのメニューから「ターミナル」→「新しいターミナル」を選択して、ターミナルを開きます。
以下のコマンドで、Go がインストールされていることを確認します。
go version
以下のように Go のバージョンが表示されれば、インストールは確認できています。
go version go1.x.x darwin/arm64
バージョンが表示されない場合は、Goのインストール を先に実施してください。
インストールが確認できたら、以下のコマンドを実行します。
go run main.go
以下のような実行結果が表示されます。
http://localhost:8080 で起動
起動メッセージだけが表示され、そのままサーバがリクエスト待ちの状態になります(実行中)。
別のターミナルから curl でアクセスします。
curl http://localhost:8080/
以下のような実行結果が表示されます。
Hello, Go Web!
登録したハンドラが Hello, Go Web! をレスポンスボディとして返し、curl の出力に現れました。たった数行でWebサーバが立ち上がっていることが確認できます。
コードを解説します。
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
...
})
http.HandleFunc は「このパスに来たリクエストを、この関数で処理する」という登録です。第2引数のハンドラ関数は、レスポンスへの書き出し口(http.ResponseWriter)と、受け取ったリクエスト(*http.Request)を受け取ります。
http.ListenAndServe(":8080", nil)
指定ポートでサーバを起動します。第2引数の nil は「デフォルトのマルチプレクサ(http.DefaultServeMux)を使う」を意味します。この節では明示的に ServeMux を作る書き方も後で紹介します。