この記事はMakuake Advent Calendar 2023の19日目の記事です。
なんでこんな大遅刻かというと、唯一埋まっていなかった19日の枠を急遽埋めようと思って投稿したため。元々掴んでいた枠ではないので遅刻ではない。
概要
去年くらいからGoのnet/httpに含まれるServeMuxの機能拡張の提案が出ていてウォッチしていたのだが、最近Closedになったらしい。
cf. net/http: enhanced ServeMux routing #61410 cf. GoでServeMuxの機能拡張を提案するProposalがAcceptedになった アプリケーション
この機能拡張はGo1.22に含まれる想定らしく、Go1.22rc2がリリースされたので試してみた。（Go1.22rc1から含まれているようだが、スルーしていた。）
Go1.22でのnet/httpの変更点
tip.golang.org/doc/go1.22#net/httpに記載されている内容を見ると、以下のような変更点があるようだ。
- ServeFileFSs、FileServerFS、NewFileTransportFSが新規追加
- HTTPサーバーとクライアントが無効なからのContent-Lengthヘッダーを含むリクエストとレスポンスを拒否するように変更
- Request.PathValueとRequest.SetPathValueが新規追加
ここを見た限りだとルーティングの仕様がどんな感じになったのかよくわからないので、ドキュメントの方を参照してみると色々書かれている。
cf. pkg.go.dev/net/http@go1.22rc2#ServeMux
Proposalの内容は全て追えていないのだが、Proposalで提案されていたルーティングのパターンマッチングの仕様がサードパーティのルーターのように充実した模様。
目立つところだけ端的にいうと、HTTPメソッド名やパスパラメータを使ったパターンマッチができるようになった感じ。
Go1.22rc2でServeMuxの新しい機能を試してみる
go.dev/dl - All releasesよりgo1.22rc2をダウンロードして触ってみる。
package main
import (
"net/http"
)
func main() {
mux := http.NewServeMux()
// HTTPメソッドがないパターンは全てのメソッドに一致する。
// {$}は特別なワイルドカードで、URLの末尾にのみ一致する。
// /{$}は/のみに一致するが、/は全てのパスに一致してしまう。
mux.HandleFunc("/{$}", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("/{$}"))
})
// GETメソッドはGETとHEADに一致する。
// {bar}はワイルドカード
mux.HandleFunc("GET /foo/{bar}", func(w http.ResponseWriter, r *http.Request) {
// パスパラメータの取得
v := r.PathValue("bar")
w.Write([]byte("GET /foo/" + v))
})
// {bar}はワイルドカード
mux.HandleFunc("POST /foo/{bar}", func(w http.ResponseWriter, r *http.Request) {
// パスパラメータの取得
v := r.PathValue("bar")
w.Write([]byte("POST /foo/" + v))
})
http.ListenAndServe(":8080", mux)
}
{$}やメソッドとルートを一緒に定義する形はサードパーティのルーターではあんまり見ないかもしれない。（自分が知らないだけかも...）
下位互換性については、pkg.go.dev/net/http@go1.22rc2#hdr-Compatibilityに記載されている。
Go1.21の仕様を引き継ぎたい場合は、httpmuuxgo121=1をGODEBUG環境変数に設定する必要があるとのこと。
所感
自作ルーターであるgoblinはもはや使う必要がなくなってしまった気がするので、個人プロジェクトは新しいServeMuxを使っていくように切り替えていこうかと思う。
