※注意: この記事ははあくまで個人学習用に整理しただけの記事で、内容としては不完全なものになります。読んでも参考にならない可能性が高いです。
ServeMux と DefaultServeMux の違いについて、具体的に把握したい。
ServeMux については不完全な内容ながら以下にメモした。
Go の ServeMux について
DefaultServeMux とは
公式ドキュメントには以下のようにコメントしてある。
https://golang.org/src/net/http/server.go?h=defaultServeMux#L2240
DefaultServeMux is the default ServeMux used by Serve.
DefaultServeMuxは、Serveが使用するデフォルトのServeMuxです。
var DefaultServeMux = &defaultServeMux
var defaultServeMux ServeMux
defaultServeMux は単なる変数名で、ServeMux 構造体のポインタが格納されている。
以下にはこのようにコメントがある
https://golang.org/src/net/http/server.go?h=defaultServeMux#L2527
// A Server defines parameters for running an HTTP server.
// The zero value for Server is a valid configuration.
type Server struct {
Addr string
Handler Handler // handler to invoke, http.DefaultServeMux if nil
handler to invoke, http.DefaultServeMux if nil
呼び出すハンドラ。 nil の場合は http.DefaultServeMux
そして、その実装が以下
// serverHandler delegates to either the server's Handler or
// DefaultServeMux and also handles "OPTIONS *" requests.
type serverHandler struct {
srv *Server
}
func (sh serverHandler) ServeHTTP(rw ResponseWriter, req *Request) {
handler := sh.srv.Handler
if handler == nil {
handler = DefaultServeMux // ここで DefaultServeMux が使用されている
}
if req.RequestURI == "*" && req.Method == "OPTIONS" {
handler = globalOptionsHandler{}
}
handler.ServeHTTP(rw, req)
}
なるほど。結局 ServeMux と DefaultServeMux は同じ型だった。
ちなみに、上記の serverHander.ServeHTTP は以下で実行されている
https://golang.org/src/net/http/server.go?h=serve#L1925
func (c *conn) serve(ctx context.Context) {
// 省略
serverHandler{c.server}.ServeHTTP(w, w.req) // ここで実行
conn.serve は以下で実行されている
https://golang.org/src/net/http/server.go?h=serve#L2969
func (srv *Server) Serve(l net.Listener) error {
// 省略
go c.serve(connCtx) // ここで実行
Server.Serve は以下で実行されている
https://golang.org/src/net/http/server.go?h=serve#L2866
func (srv *Server) ListenAndServe() error {
if srv.shuttingDown() {
return ErrServerClosed
}
addr := srv.Addr
if addr == "" {
addr = ":http"
}
ln, err := net.Listen("tcp", addr)
if err != nil {
return err
}
return srv.Serve(ln) // ここで実行
}
Server.ListenAndServe は直接実行する場合もあるし、http. ListenAndServe から実行されることもある。
http.ListenAndServe 内の server.ListenAndServe 実行箇所は以下。
https://golang.org/src/net/http/server.go?h=serve#L3120
func ListenAndServe(addr string, handler Handler) error {
server := &Server{Addr: addr, Handler: handler}
return server.ListenAndServe() // ここで実行
}
例えば、以下のようにサーバーを作成した場合、DefaultServeMux ではなく http.NewServeMux（） で作成した mux が使用されるが、
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/", index)
server := &http.Server{
Addr: config.Address,
Handler: mux, // Handler に mux を設定した場合、DefaultServeMux ではなくこれが使用される
ReadTimeout: time.Duration(config.ReadTimeout * int64(time.Second)),
WriteTimeout: time.Duration(config.WriteTimeout * int64(time.Second)),
MaxHeaderBytes: 1 << 20,
}
server.ListenAndServe()
}
以下のようにサーバーを作成した場合は、 DefaultServeMux が使用されるということか。
func main() {
http.Handle("/", &templateHandler{filename: "index.html"})
// この場合、マルチプレクサを特に設定していない事になるため、DefaultServeMux が使用される
if err := http.ListenAndServe(":8080", nil); err != nil {
log.Fatal("ListenAndServe:", err)
}
}
なるほど。一旦雑に理解。