Keywords: HandlerFunc, ServeHTTP, NotFoundHandler

前言

在Go-HTTP中，已经介绍了HandlerFunc。为了查阅方便，单独再拎出来讲一讲。

原始代码

定义在server.go文件中，如下。

// The HandlerFunc type is an adapter to allow the use of
// ordinary functions as HTTP handlers. If f is a function
// with the appropriate signature, HandlerFunc(f) is a
// Handler that calls f.
type HandlerFunc func(ResponseWriter, *Request)

// ServeHTTP calls f(w, r).
func (f HandlerFunc) ServeHTTP(w ResponseWriter, r *Request) {
    f(w, r)
}

功能

HandlerFunc是一种数据类型，或者严格地讲，是函数类型。不管怎么说，HandlerFunc是一种type是无疑问的。而且，这个HandlerFunc实现了Handler接口的ServerHttp方法，所以HandlerFunc是Handler的具体类。

惯用法

习惯上，先定义自己的符合如下前面的函数：

func(ResponseWriter, *Request)

然后通过“类型转换”，将该函数转换成HandlerFunc类型，从而就变成了Handler对象。

示例

在Go-HTTP一文，给出了相关的示例代码，再次拷贝过来(msgHandler)：

package main 

import (
    "fmt"
    "log"
    "net/http"
)

func msgHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprint(w, "Hello, HandlerFunc!")
}

func main() {
    mux := http.NewServeMux()

    handler := http.HandlerFunc(msgHandler)

    mux.Handle("/hello",  handler)

    log.Println("Listening...")
    http.ListenAndServe(":8080", mux)
}

NotFoundHandler

server.go中的NotFoundHandler使用了同样的手法：

// Error replies to the request with the specified error message and HTTP code.
// It does not otherwise end the request; the caller should ensure no further
// writes are done to w.
// The error message should be plain text.
func Error(w ResponseWriter, error string, code int) {
    w.Header().Set("Content-Type", "text/plain; charset=utf-8")
    w.Header().Set("X-Content-Type-Options", "nosniff")
    w.WriteHeader(code)
    fmt.Fprintln(w, error)
}

// NotFound replies to the request with an HTTP 404 not found error.
func NotFound(w ResponseWriter, r *Request) { Error(w, "404 page not found", StatusNotFound) }

// NotFoundHandler returns a simple request handler
// that replies to each request with a ``404 page not found'' reply.
func NotFoundHandler() Handler { return HandlerFunc(NotFound) }

这里的NotFound()函数符合HandlerFunc类型的函数原型，所以通过HandlerFunc(NotFound)这个类型转换，就生成了一个Handler对象。

正如server.go注释所说的，NotFoundHandler这种都是helper形式的handler。——最开始接触helper，是接触ns3源码的时候，ns3很多代码就是xxxHelper这种命名方式。