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 を作る書き方も後で紹介します。