【Go】http.ListenAndServe と server.ListenAndServe の違いについて

※注意: この記事ははあくまで個人学習用に整理しただけの記事で、内容としては不完全なものになります。読んでも参考にならない可能性が高いです。

http.ListenAndServe と server.ListenAndServe の違い

http.ListenAndServe 使用例

func main() {
    http.Handle("/", &templateHandler{filename: "index.html"})

    if err := http.ListenAndServe(":8080", nil); err != nil {
        log.Fatal("ListenAndServe:", err)
    }
}

server.ListenAndServe() 使用例

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/", index)
    server := &http.Server{
        Addr:           config.Address,
        Handler:        mux,
        ReadTimeout:    time.Duration(config.ReadTimeout * int64(time.Second)),
        WriteTimeout:   time.Duration(config.WriteTimeout * int64(time.Second)),
        MaxHeaderBytes: 1 << 20,
    }
    server.ListenAndServe()
}

http パッケージの Server struct を確認
https://golang.org/src/net/http/server.go?h=ListenAndServe#L2520

type Server struct {
    Addr            string
    Handler         Handler // handler to invoke, http.DefaultServeMux if nil
    TLSConfig       *tls.Config
    ReadTimeout     time.Duration
    ReadHeaderTimeout   time.Duration
    WriteTimeout        time.Duration
    IdleTimeout     time.Duration
    MaxHeaderBytes      int
    TLSNextProto        map[string]func(*Server, *tls.Conn, Handler)
    ConnState       func(net.Conn, ConnState)
    ErrorLog        *log.Logger
    BaseContext     func(net.Listener) context.Context
    ConnContext     func(ctx context.Context, c net.Conn) context.Context
    inShutdown      atomicBool
    disableKeepAlives   int32
    nextProtoOnce       sync.Once
    nextProtoErr        error
    mu          sync.Mutex
    listeners       map[*net.Listener]struct{}
    activeConn      map[*conn]struct{}
    doneChan        chan struct{}
    onShutdown      []func()
}

server struct の ListenAndServe method を確認すると

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)
}

上記のようになっており、特に仮引数は受け取らない。

続いて http ListenAndServe 関数を確認

func ListenAndServe(addr string, handler Handler) error {
    server := &Server{Addr: addr, Handler: handler}
    return server.ListenAndServe()
}

こちらは addr 文字列と handler を仮引数で受け取るようになっている。
関数内部で Server struct のポインタで初期化し、server.ListenAndServe() を実行している。

つまり、http.ListenAndServe(":8080", nil) で実行する場合、addr と handler しか指定することができない。また、その際に、マルチプレクサも指定できない為、DefaultServeMux が使用されるという仕組みのようだ。

自分の中の結論としては、

• addr と handler のみを指定したい場合は http.ListenAndServe を使用
• addr と handler 以外も指定したい場合は server.ListenAndServe を使用

という理解になった。