http.HandleFunc、http.HandlerFuncの違いをまとめてみた。

前回の記事の続き。

##http.Handlerとhttp.HandlerFuncの違いって何なんだよ

###http.Handler:インターフェース(ResponseWriterと*Requestを引数に取るServeHttpメソッドさえあれば全部Handlerとして扱える！)

server.go

type Handler interface {
	ServeHTTP(ResponseWriter, *Request)
}

###http.HandlerFunc:型(ResponseWriterと*Requestを引数に取るメソッドならなんでもHandlerFunc型)

server.go

type HandlerFunc func(ResponseWriter, *Request)

##http.Handleとhttp.HandleFuncの違いって何なんだよ

###http.Handle:メソッド(DefaultServeMux.Handleのラッピング)

server.go

func Handle(pattern string, handler Handler) { DefaultServeMux.Handle(pattern, handler) }

###http.HandleFunc:メソッド(DefaultServeMux.HandleFuncのラッピング)

server.go

func HandleFunc(pattern string, handler func(ResponseWriter, *Request)) {
	DefaultServeMux.HandleFunc(pattern, handler)
}

##DefaultServeMux.HandleとDefaultServeMux.HandleFuncの違いって何なんだよ

###DefaultServeMux.Handle:メソッド(パターン(URL)とHandlerを紐づける！)

server.go

// Handle registers the handler for the given pattern.
// If a handler already exists for pattern, Handle panics.
func (mux *ServeMux) Handle(pattern string, handler Handler) {
	mux.mu.Lock()
	defer mux.mu.Unlock()

	if pattern == "" {
		panic("http: invalid pattern")
	}
	if handler == nil {
		panic("http: nil handler")
	}
	if _, exist := mux.m[pattern]; exist {
		panic("http: multiple registrations for " + pattern)
	}

	if mux.m == nil {
		mux.m = make(map[string]muxEntry)
	}
	e := muxEntry{h: handler, pattern: pattern}
	mux.m[pattern] = e
	if pattern[len(pattern)-1] == '/' {
		mux.es = appendSorted(mux.es, e)
	}

	if pattern[0] != '/' {
		mux.hosts = true
	}
}

###DefaultServeMux.HandleFunc:DefaultServeMux.Handleを呼び出す。

server.go

// HandleFunc registers the handler function for the given pattern.
func (mux *ServeMux) HandleFunc(pattern string, handler func(ResponseWriter, *Request)) {
	if handler == nil {
		panic("http: nil handler")
	}
	mux.Handle(pattern, HandlerFunc(handler))
}

#結局、違いって何だったの？

http.Handleを呼び出すには、http.Handler(ServeHttpメソッドを持つインターフェース)が必要でした。
でも、http.HandleFuncを呼び出すには、インターフェースは不要で、単にResponseWriter, *Requestを引数に持つファンクションさえ渡せばよい。

つまり、実際にHandlerを登録する作業はhttp.Handleにhttp.Handler(インターフェース)を渡す必要があるけど、
プログラマが実際にハンドラを登録する時には、http.HandleFuncにhttp.HandleFunc(ファンクション)を渡せばよい。