Go語(yǔ)言的Handler有什么用

這篇文章主要介紹“Go語(yǔ)言的Handler有什么用”，在日常操作中，相信很多人在Go語(yǔ)言的Handler有什么用問(wèn)題上存在疑惑，小編查閱了各式資料，整理出簡(jiǎn)單好用的操作方法，希望對(duì)大家解答”Go語(yǔ)言的Handler有什么用”的疑惑有所幫助！接下來(lái)，請(qǐng)跟著小編一起來(lái)學(xué)習(xí)吧！

Multiplexer根據(jù)URL將請(qǐng)求路由給指定的Handler。Handler用于處理請(qǐng)求并給予響應(yīng)。更嚴(yán)格地說(shuō)，用來(lái)讀取請(qǐng)求體、并將請(qǐng)求對(duì)應(yīng)的響應(yīng)字段(respones header)寫(xiě)入ResponseWriter中，然后返回。

什么是Handler

什么是Handler。它是一個(gè)接口，定義在net/http/server.go中：

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

也就是說(shuō)，實(shí)現(xiàn)了ServerHTTP方法的都是Handler。注意ServerHTTP方法的參數(shù)：http.ResponesWriter接口和Request指針。

在Handler的注釋中，給出了幾點(diǎn)主要的說(shuō)明：

• Handler用于響應(yīng)一個(gè)HTTP request

• 接口方法ServerHTTP應(yīng)該用來(lái)將response header和需要響應(yīng)的數(shù)據(jù)寫(xiě)入到ResponseWriter中，然后返回。返回意味著這個(gè)請(qǐng)求已經(jīng)處理結(jié)束，不能再使用這個(gè)ResponseWriter、不能再?gòu)腞equest.Body中讀取數(shù)據(jù)，不能并發(fā)調(diào)用已完成的ServerHTTP方法

• handler應(yīng)該先讀取Request.Body，然后再寫(xiě)ResponseWriter。只要開(kāi)始向ResponseWriter寫(xiě)數(shù)據(jù)后，就不能再?gòu)腞equest.Body中讀取數(shù)據(jù)

• handler只能用來(lái)讀取request的body，不能修改已取得的Request(因?yàn)樗膮?shù)Request是指針類型的)

ResponseWriter接口說(shuō)明

再看看ResponseWriter接口的定義：

// A ResponseWriter interface is used by an HTTP handler to
// construct an HTTP response.
//
// A ResponseWriter may not be used after the Handler.ServeHTTP method
// has returned.
type ResponseWriter interface {
	Header() Header
	Write([]byte) (int, error)
	WriteHeader(statusCode int)
}

注釋中已經(jīng)說(shuō)明，ResponseWriter接口的作用是用于構(gòu)造HTTP response。且明確指定了Handler.ServerHTTP方法返回以后就不能再使用ResponseWriter了。

這個(gè)接口有3個(gè)方法：

• Header()方法用來(lái)構(gòu)造響應(yīng)Header，它返回一個(gè)Header對(duì)象，這個(gè)Header對(duì)象稍后將被WriterHeader()響應(yīng)出去。Header類型是一個(gè)map類型的結(jié)構(gòu)，字段名為key、字段值為value：

  type Header map[string][]string

• Write()方法用于向網(wǎng)絡(luò)連接中寫(xiě)響應(yīng)數(shù)據(jù)。

• WriteHeader()方法將給定的響應(yīng)狀態(tài)碼和響應(yīng)Header一起發(fā)送出去。

很顯然，ResponseWriter的作用是構(gòu)造響應(yīng)header，并將響應(yīng)header和響應(yīng)數(shù)據(jù)通過(guò)網(wǎng)絡(luò)鏈接發(fā)送給客戶端。

再看ListenAndServe()

在啟動(dòng)go http自帶的web服務(wù)時(shí)，調(diào)用了函數(shù)ListenAndServe()。這個(gè)函數(shù)的定義如下：

func ListenAndServe(addr string, handler Handler) error

該函數(shù)有兩個(gè)參數(shù)，第一個(gè)參數(shù)是自帶的web監(jiān)聽(tīng)地址和端口，第二個(gè)參數(shù)是Handler，用來(lái)處理每個(gè)接進(jìn)來(lái)的http request，但一般第二個(gè)參數(shù)設(shè)置為nil，表示調(diào)用默認(rèn)的Multiplexer：DefaultServeMux。這個(gè)默認(rèn)的ServeMux唯一的作用，是將請(qǐng)求根據(jù)URL路由給對(duì)應(yīng)的handler進(jìn)行處理。

var DefaultServeMux = &defaultServeMux

這里有兩個(gè)問(wèn)題：

• (1).第二個(gè)參數(shù)為什么建議設(shè)置為nil

• (2).設(shè)置為nil后，DefaultServeMux是請(qǐng)求的路由器，它為什么可以充當(dāng)一個(gè)handler

先看第二個(gè)問(wèn)題，很簡(jiǎn)單，因?yàn)镾erveMux類型定義了ServeHTTP()方法，它實(shí)現(xiàn)了Handler接口：

type ServeMux struct {
        // Has unexported fields.
}
func NewServeMux() *ServeMux
func (mux *ServeMux) Handle(pattern string, handler Handler)
func (mux *ServeMux) HandleFunc(pattern string, handler func(ResponseWriter, *Request))
func (mux *ServeMux) Handler(r *Request) (h Handler, pattern string)
func (mux *ServeMux) ServeHTTP(w ResponseWriter, r *Request)

前面說(shuō)過(guò)，只要實(shí)現(xiàn)了ServerHTTP()方法的類型，就是一個(gè)Handler。而DefaultServeMux是默認(rèn)的ServeMux，所以它是一個(gè)Handler。

關(guān)于第一個(gè)問(wèn)題，看一個(gè)示例就知道了。

package main

import (
	"fmt"
	"net/http"
)

// MyHandler實(shí)現(xiàn)Handler接口
type MyHandler struct{}

func (h *MyHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "Hello World!\n")
}

func main() {
	handler := MyHandler{}
	server := http.Server{
		Addr:    "127.0.0.1:8080",
		Handler: &handler,      // 以&handler作為第二個(gè)參數(shù)
	}
	server.ListenAndServe()
}

上面的示例中定義了一個(gè)handler，它實(shí)現(xiàn)的ServeHTTP()方法只有一個(gè)作用，輸出Hello World!。并且將這個(gè)handler作為L(zhǎng)istenAndServe()的第二個(gè)參數(shù)。

注意，上面以&handler作為參數(shù)而非handler，因?yàn)榇颂嶮yHandler中實(shí)現(xiàn)的ServerHTTP()方法的receiver是指針類型的，所以MyHandler的實(shí)例對(duì)象也必須是指針類型的，如此才能實(shí)現(xiàn)Handler接口。

啟動(dòng)這個(gè)web服務(wù)后，以不同的URL去訪問(wèn)它，將總是得到完全相同的響應(yīng)結(jié)果：

很顯然，當(dāng)handler作為L(zhǎng)istenAndServe()的第二個(gè)參數(shù)時(shí)，任意請(qǐng)求都會(huì)使用這個(gè)唯一的handler進(jìn)行處理。

所以，建議將第二個(gè)參數(shù)設(shè)置為nil(或者上面的Serve Struct不指定Handler字段)，它表示調(diào)用默認(rèn)的DefaultServeMux作為handler，使得每個(gè)訪問(wèn)請(qǐng)求都會(huì)調(diào)用這個(gè)特殊的handler，而這個(gè)handler的作用是將請(qǐng)求根據(jù)url路由給不同的handler。

另外需要注意的是，http包中提供的Handle()和HandleFunc()函數(shù)其實(shí)是DefaultServeMux.XXX的封裝，所以直接調(diào)用http.Handle()和http.HandleFunc()實(shí)際上是在調(diào)用DefaultServeMux.Handle()和DefaultServeMux.HandleFunc()。

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

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

使用DefaultServeMux后的Handler示例

下面是使用了DefaultServeMux的示例。

創(chuàng)建了兩個(gè)handler，一個(gè)handler用于對(duì)應(yīng)/hello，該handler用于輸出Hello，另一個(gè)handler用于對(duì)應(yīng)world，該handler用于輸出World：

package main

import (
	"fmt"
	"net/http"
)

type HelloHandler struct{}
type WorldHandler struct{}

func (h *HelloHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "Hello\n")
}
func (h *WorldHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "World\n")
}

func main() {
	helloHandler := HelloHandler{}
	worldHandler := WorldHandler{}
	server := http.Server{
		Addr:    "127.0.0.1:8080",
	}
	http.Handle("/hello",&helloHandler)
	http.Handle("/world",&worldHandler)
	server.ListenAndServe()
}

下面是訪問(wèn)的結(jié)果：

HandleFunc是什么

除了使用Handle處理http請(qǐng)求，也能使用HandleFunc()處理。

先看一個(gè)使用HandleFunc()處理請(qǐng)求的示例，示例的效果和前文是一樣的。

package main

import (
	"fmt"
	"net/http"
)

func hello(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "Hello\n")
}

func world(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "World\n")
}

func main() {
	server := http.Server{
		Addr: "127.0.0.1:8080",
	}
	http.HandleFunc("/hello", hello)
	http.HandleFunc("/world", world)

	server.ListenAndServe()
}

下面是訪問(wèn)的結(jié)果：

Go有一個(gè)函數(shù)HandleFunc()，它表示使用第二個(gè)參數(shù)的函數(shù)作為handler，處理匹配到的url路徑請(qǐng)求。

func HandleFunc(pattern string, handler func(ResponseWriter, *Request))

不難看出，HandleFunc()使得我們可以直接使用一個(gè)函數(shù)作為handler，而不需要自定義一個(gè)實(shí)現(xiàn)Handler接口的類型。正如上面的示例中，我們沒(méi)有定義Handler類型，也沒(méi)有去實(shí)現(xiàn)ServeHTTP()方法，而是直接定義函數(shù)，并將其作為handler。

換句話說(shuō)，HandleFunc()使得我們可以更簡(jiǎn)便地為某些url路徑注冊(cè)handler。但是，使用HandleFunc()畢竟是圖簡(jiǎn)便，有時(shí)候不得不使用Handle()，比如我們確定要定義一個(gè)type。

Handle()、HandleFunc()和Handler、HandlerFunc的關(guān)系

說(shuō)實(shí)話，一開(kāi)始感覺(jué)挺亂的。

Handle()和HandleFunc()是函數(shù)，用來(lái)給url綁定handler。Handler和HandlerFunc類型，用來(lái)處理請(qǐng)求。

看Handle()、HandleFunc()以及Handler、HandlerFunc的定義就已經(jīng)很清晰了：

func Handle(pattern string, handler Handler) {}
func HandleFunc(pattern string, handler func(ResponseWriter, *Request)) {}

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

type HandlerFunc func(ResponseWriter, *Request)
func (f HandlerFunc) ServeHTTP(w ResponseWriter, r *Request)

Handle()和HandleFunc()都是為某個(gè)url路徑模式綁定一個(gè)對(duì)應(yīng)的handler，只不過(guò)HandleFunc()是直接使用函數(shù)作為handler，而Handle()是使用Handler類型的實(shí)例作為handler。

Handler接口的實(shí)例都實(shí)現(xiàn)了ServeHTTP()方法，都用來(lái)處理請(qǐng)求并響應(yīng)給客戶端。

HandlerFunc類型不是接口，但它有一個(gè)方法ServeHTTP()，也就是說(shuō)HandlerFunc其實(shí)也是一種Handler。

因?yàn)镠andlerFunc是類型，只要某個(gè)函數(shù)的簽名是func(ResponseWriter, *Request)，它就是HandlerFunc類型的一個(gè)實(shí)例。另一方面，這個(gè)類型的實(shí)例(可能是參數(shù)、可能是返回值類型)可以和某個(gè)簽名為func(ResponseWriter, *Request)的函數(shù)進(jìn)行互相賦值。這個(gè)過(guò)程可能很隱式，但確實(shí)經(jīng)常出現(xiàn)相關(guān)的用法。

例如：

// 一個(gè)函數(shù)類型的handler
func myhf(ResponseWriter, *Request){}

// 以HandlerFunc類型作為參數(shù)類型
func a(hf HandlerFunc){}

// 所以，可以將myhf作為a()的參數(shù)
a(myhf)

實(shí)際上，可以使用HandlerFunc()進(jìn)行轉(zhuǎn)換。例如有一個(gè)函數(shù)world()，它的參數(shù)是合理的，使用HandlerFunc(world)表示將其轉(zhuǎn)換為一個(gè)Handler。這個(gè)轉(zhuǎn)換、適應(yīng)在后面會(huì)經(jīng)常用到。

例如：

// 兩個(gè)函數(shù)
func hello(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "Hello\n")
}

func world(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "World\n")
}

func main() {
	server := http.Server{
		Addr: "127.0.0.1:8080",
	}
    // 第一個(gè)使用HandleFunc()為路徑注冊(cè)hello()函數(shù)handler
    // 第二個(gè)使用Handle()為路徑注冊(cè)轉(zhuǎn)換后的handler
	http.HandleFunc("/hello", hello)
	http.Handle("/world", http.HandlerFunc(world))

	server.ListenAndServe()
}

上面的示例中，Handle()函數(shù)的第二個(gè)參數(shù)要求的是Handler類型，使用http.HandlerFunc(world)就將函數(shù)world()轉(zhuǎn)換成了Handler類型的一個(gè)實(shí)例。

鏈?zhǔn)絟andler

handler是用來(lái)處理http請(qǐng)求的，處理過(guò)程可能會(huì)很簡(jiǎn)單，也可能會(huì)很復(fù)雜。復(fù)雜的情況下，可能無(wú)法使用一個(gè)單獨(dú)的handler來(lái)完成工作，畢竟handler只是一個(gè)函數(shù)。盡管我們可以直接在這個(gè)函數(shù)中調(diào)用其它函數(shù)。

很經(jīng)常地，可能handler中需要嵌套其它handler，甚至多層嵌套，這就是鏈?zhǔn)絟andler。

由于Handle()或HandleFunc()注冊(cè)的時(shí)候需要指定參數(shù)類型，所以handler嵌套的時(shí)候，也要關(guān)注handler的參數(shù)類型以及返回類型?？聪旅媸纠蜁?huì)明白參數(shù)類型和返回類型是怎么要求的。

HandleFunc()的嵌套示例

代碼如下：

package main

import (
	"fmt"
	"net/http"
)

func hello(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "Hello World!\n")
}

func log(hf http.HandlerFunc) http.HandlerFunc {
	count := 0
	return func(w http.ResponseWriter, r *http.Request) {
		count++
		fmt.Printf("Handler Function called %d times\n", count)
		hf(w, r)
	}
}

func main() {
	server := http.Server{
		Addr: "127.0.0.1:8080",
	}
	http.HandleFunc("/hello", log(hello))
	server.ListenAndServe()
}

多次訪問(wèn)http://127.0.0.1:8080/hello，將在瀏覽器中輸出"Hello World!"，但同時(shí)會(huì)在運(yùn)行這個(gè)go程序的終端上多次輸出以下內(nèi)容：

$ go run test.go
Handler Function called 1 times
Handler Function called 2 times
Handler Function called 3 times
Handler Function called 4 times
Handler Function called 5 times

上面的示例中，主要看下面兩段代碼：

func hello(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "Hello World!\n")
}

func log(hf http.HandlerFunc) http.HandlerFunc {
	count := 0
	return func(w http.ResponseWriter, r *http.Request) {
		count++
		fmt.Printf("Handler Function called %d times\n", count)
		hf(w, r)
	}
}

hello()是一個(gè)普通的HandlerFunc類型函數(shù)，因?yàn)樗暮灻螲andlerFunc類型，所以它是HandlerFunc類型的一個(gè)實(shí)例。而log()函數(shù)正是以HandlerFunc類型作為參數(shù)的，所以前面的示例代碼中，將hello函數(shù)作為了log函數(shù)的參數(shù)：

http.HandleFunc("/hello", log(hello))

HandleFunc()的第二個(gè)參數(shù)要求是HandlerFunc類型的，所以log()的返回值是HandlerFunc類型。在log()中，使用匿名函數(shù)作為它的返回值，這里的這個(gè)匿名函數(shù)是一個(gè)閉包(因?yàn)橐昧送鈱雍瘮?shù)的變量hf和count)。這個(gè)匿名函數(shù)最后調(diào)用hf(w,r)，由于hf是HandlerFunc類型的一個(gè)實(shí)例，所以可以如此調(diào)用。

上面體現(xiàn)了HandlerFunc嵌套時(shí)候關(guān)于參數(shù)以及返回值的一些細(xì)節(jié)。

上面的示例中還有一個(gè)細(xì)節(jié)需要引起注意：為什么每次訪問(wèn)時(shí)，上面的count都會(huì)記住之前的值并自增，而不是重置為0后自增。

之所以有這個(gè)疑問(wèn)，可能是認(rèn)為每次訪問(wèn)時(shí)，請(qǐng)求處理完成后handler就退出了，閉包雖然會(huì)記住外層函數(shù)的自由變量count，但也會(huì)因?yàn)樘幚硗瓿珊笸顺?，?dǎo)致每次訪問(wèn)都重置為0后自增。但實(shí)際上，handler是注冊(cè)在給定路徑上的，只要web服務(wù)沒(méi)有退出，這個(gè)handler就一直不會(huì)退出，不會(huì)因?yàn)槊看卧L問(wèn)都重新注冊(cè)handler。所以，閉包handler一直引用著hf和count這兩個(gè)自由變量。

HandlerFunc嵌套Handler

將上面的HandlerFunc嵌套HandlerFunc修改一下，變成Handler嵌套HandlerFunc。

package main

import (
	"fmt"
	"net/http"
)

type MyHandler struct{}

func (wh *MyHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "Hello World!\n")
}

func log(h http.Handler) http.Handler {
	count := 0
	f := func(w http.ResponseWriter, r *http.Request) {
		count++
		fmt.Printf("Handler Function called %d times\n", count)
		h.ServeHTTP(w, r)
	}
	return http.HandlerFunc(f)
}

func main() {
	myHandler := MyHandler{}
	server := http.Server{
		Addr: "127.0.0.1:8080",
	}
	http.Handle("/hello", log(&myHandler))
	server.ListenAndServe()
}

邏輯也很簡(jiǎn)單，無(wú)非是將HandlerFunc轉(zhuǎn)換成Handler。

思考一下，Handler是否可以嵌套Handler，或者Handler嵌套HandlerFunc?？梢裕呛懿环奖?，因?yàn)镾erveHTTP()方法限制了沒(méi)法調(diào)用其它的Handler，除非定義的某個(gè)Handler是嵌套在某個(gè)Handler類型中的類型。

到此，關(guān)于“Go語(yǔ)言的Handler有什么用”的學(xué)習(xí)就結(jié)束了，希望能夠解決大家的疑惑。理論與實(shí)踐的搭配能更好的幫助大家學(xué)習(xí)，快去試試吧！若想繼續(xù)學(xué)習(xí)更多相關(guān)知識(shí)，請(qǐng)繼續(xù)關(guān)注億速云網(wǎng)站，小編會(huì)繼續(xù)努力為大家?guī)?lái)更多實(shí)用的文章！