gopl-zh.github.com/ch7/ch7-07.md

199 lines
9.6 KiB
Markdown
Raw Normal View History

2015-12-09 07:45:11 +00:00
## 7.7. http.Handler接口
2016-01-18 01:53:55 +00:00
2018-06-09 16:27:25 +00:00
在第一章中我们粗略的了解了怎么用net/http包去实现网络客户端§1.5和服务器§1.7。在这个小节中我们会对那些基于http.Handler接口的服务器API做更进一步的学习
2016-01-18 01:53:55 +00:00
2016-01-21 02:22:10 +00:00
<u><i>net/http</i></u>
2016-01-13 15:23:42 +00:00
```go
package http
2015-12-09 07:45:11 +00:00
2016-01-13 15:23:42 +00:00
type Handler interface {
2016-01-18 02:52:21 +00:00
ServeHTTP(w ResponseWriter, r *Request)
2016-01-13 15:23:42 +00:00
}
func ListenAndServe(address string, h Handler) error
```
2016-01-18 01:53:55 +00:00
2016-02-15 03:06:34 +00:00
ListenAndServe函数需要一个例如“localhost:8000”的服务器地址和一个所有请求都可以分派的Handler接口实例。它会一直运行直到这个服务因为一个错误而失败或者启动失败它的返回值一定是一个非空的错误。
2016-01-13 15:23:42 +00:00
想象一个电子商务网站为了销售将数据库中物品的价格映射成美元。下面这个程序可能是能想到的最简单的实现了。它将库存清单模型化为一个命名为database的map类型我们给这个类型一个ServeHttp方法这样它可以满足http.Handler接口。这个handler会遍历整个map并输出物品信息。
2016-01-18 01:53:55 +00:00
2016-01-21 02:22:10 +00:00
<u><i>gopl.io/ch7/http1</i></u>
2016-01-13 15:23:42 +00:00
```go
func main() {
2016-01-18 02:52:21 +00:00
db := database{"shoes": 50, "socks": 5}
log.Fatal(http.ListenAndServe("localhost:8000", db))
2016-01-13 15:23:42 +00:00
}
type dollars float32
func (d dollars) String() string { return fmt.Sprintf("$%.2f", d) }
type database map[string]dollars
func (db database) ServeHTTP(w http.ResponseWriter, req *http.Request) {
2016-01-18 02:52:21 +00:00
for item, price := range db {
fmt.Fprintf(w, "%s: %s\n", item, price)
}
2016-01-13 15:23:42 +00:00
}
```
2016-01-18 01:53:55 +00:00
2016-02-15 03:06:34 +00:00
如果我们启动这个服务,
2016-01-18 01:53:55 +00:00
2016-01-13 15:23:42 +00:00
```
$ go build gopl.io/ch7/http1
$ ./http1 &
```
2016-01-18 01:53:55 +00:00
2018-05-27 20:51:15 +00:00
然后用1.5节中的获取程序如果你更喜欢可以使用web浏览器来连接服务器我们得到下面的输出
2016-01-18 01:53:55 +00:00
2016-01-13 15:23:42 +00:00
```
$ go build gopl.io/ch1/fetch
$ ./fetch http://localhost:8000
shoes: $50.00
socks: $5.00
```
2016-01-18 01:53:55 +00:00
目前为止这个服务器不考虑URL只能为每个请求列出它全部的库存清单。更真实的服务器会定义多个不同的URL每一个都会触发一个不同的行为。让我们使用/list来调用已经存在的这个行为并且增加另一个/price调用表明单个货品的价格像这样/price?item=socks来指定一个请求参数。
2016-01-18 01:53:55 +00:00
2016-01-21 02:22:10 +00:00
<u><i>gopl.io/ch7/http2</i></u>
2016-01-13 15:23:42 +00:00
```go
func (db database) ServeHTTP(w http.ResponseWriter, req *http.Request) {
2016-01-18 02:52:21 +00:00
switch req.URL.Path {
case "/list":
for item, price := range db {
fmt.Fprintf(w, "%s: %s\n", item, price)
}
case "/price":
item := req.URL.Query().Get("item")
price, ok := db[item]
if !ok {
w.WriteHeader(http.StatusNotFound) // 404
fmt.Fprintf(w, "no such item: %q\n", item)
return
}
fmt.Fprintf(w, "%s\n", price)
default:
w.WriteHeader(http.StatusNotFound) // 404
fmt.Fprintf(w, "no such page: %s\n", req.URL)
}
2016-01-13 15:23:42 +00:00
}
```
2016-01-18 01:53:55 +00:00
2016-02-15 03:06:34 +00:00
现在handler基于URL的路径部分req.URL.Path来决定执行什么逻辑。如果这个handler不能识别这个路径它会通过调用w.WriteHeader(http.StatusNotFound)返回客户端一个HTTP错误这个检查应该在向w写入任何值前完成。顺便提一下http.ResponseWriter是另一个接口。它在io.Writer上增加了发送HTTP相应头的方法。等效地我们可以使用实用的http.Error函数
2016-01-18 01:53:55 +00:00
2016-01-13 15:23:42 +00:00
```go
msg := fmt.Sprintf("no such page: %s\n", req.URL)
http.Error(w, msg, http.StatusNotFound) // 404
```
2016-01-18 01:53:55 +00:00
2016-02-15 03:06:34 +00:00
/price的case会调用URL的Query方法来将HTTP请求参数解析为一个map或者更准确地说一个net/url包中url.Values(§6.2.1)类型的多重映射。然后找到第一个item参数并查找它的价格。如果这个货品没有找到会返回一个错误。
2016-01-13 15:23:42 +00:00
2016-02-15 03:06:34 +00:00
这里是一个和新服务器会话的例子:
2016-01-18 01:53:55 +00:00
2016-01-13 15:23:42 +00:00
```
$ go build gopl.io/ch7/http2
$ go build gopl.io/ch1/fetch
$ ./http2 &
$ ./fetch http://localhost:8000/list
shoes: $50.00
socks: $5.00
$ ./fetch http://localhost:8000/price?item=socks
$5.00
$ ./fetch http://localhost:8000/price?item=shoes
$50.00
$ ./fetch http://localhost:8000/price?item=hat
no such item: "hat"
$ ./fetch http://localhost:8000/help
no such page: /help
```
2016-01-18 01:53:55 +00:00
2016-02-15 03:06:34 +00:00
显然我们可以继续向ServeHTTP方法中添加case但在一个实际的应用中将每个case中的逻辑定义到一个分开的方法或函数中会很实用。此外相近的URL可能需要相似的逻辑例如几个图片文件可能有形如/images/\*.png的URL。因为这些原因net/http包提供了一个请求多路器ServeMux来简化URL和handlers的联系。一个ServeMux将一批http.Handler聚集到一个单一的http.Handler中。再一次我们可以看到满足同一接口的不同类型是可替换的web服务器将请求指派给任意的http.Handler
而不需要考虑它后面的具体类型。
2016-01-13 15:23:42 +00:00
2016-02-15 03:06:34 +00:00
对于更复杂的应用一些ServeMux可以通过组合来处理更加错综复杂的路由需求。Go语言目前没有一个权威的web框架就像Ruby语言有Rails和python有Django。这并不是说这样的框架不存在而是Go语言标准库中的构建模块就已经非常灵活以至于这些框架都是不必要的。此外尽管在一个项目早期使用框架是非常方便的但是它们带来额外的复杂度会使长期的维护更加困难。
2016-01-13 15:23:42 +00:00
在下面的程序中我们创建一个ServeMux并且使用它将URL和相应处理/list和/price操作的handler联系起来这些操作逻辑都已经被分到不同的方法中。然后我门在调用ListenAndServe函数中使用ServeMux为主要的handler。
2016-01-18 01:53:55 +00:00
2016-01-21 02:22:10 +00:00
<u><i>gopl.io/ch7/http3</i></u>
2016-01-13 15:23:42 +00:00
```go
func main() {
2016-01-18 02:52:21 +00:00
db := database{"shoes": 50, "socks": 5}
mux := http.NewServeMux()
mux.Handle("/list", http.HandlerFunc(db.list))
mux.Handle("/price", http.HandlerFunc(db.price))
log.Fatal(http.ListenAndServe("localhost:8000", mux))
2016-01-13 15:23:42 +00:00
}
type database map[string]dollars
func (db database) list(w http.ResponseWriter, req *http.Request) {
2016-01-18 02:52:21 +00:00
for item, price := range db {
fmt.Fprintf(w, "%s: %s\n", item, price)
}
2016-01-13 15:23:42 +00:00
}
func (db database) price(w http.ResponseWriter, req *http.Request) {
2016-01-18 02:52:21 +00:00
item := req.URL.Query().Get("item")
price, ok := db[item]
if !ok {
w.WriteHeader(http.StatusNotFound) // 404
fmt.Fprintf(w, "no such item: %q\n", item)
return
}
fmt.Fprintf(w, "%s\n", price)
2016-01-13 15:23:42 +00:00
}
```
2016-01-18 01:53:55 +00:00
2018-06-09 16:27:25 +00:00
让我们关注这两个注册到handlers上的调用。第一个db.list是一个方法值§6.4),它是下面这个类型的值。
2016-01-18 01:53:55 +00:00
2016-01-13 15:23:42 +00:00
```go
func(w http.ResponseWriter, req *http.Request)
```
2016-01-18 01:53:55 +00:00
也就是说db.list的调用会援引一个接收者是db的database.list方法。所以db.list是一个实现了handler类似行为的函数但是因为它没有方法理解该方法没有它自己的方法所以它不满足http.Handler接口并且不能直接传给mux.Handle。
2016-01-13 15:23:42 +00:00
2016-02-15 03:06:34 +00:00
语句http.HandlerFunc(db.list)是一个转换而非一个函数调用因为http.HandlerFunc是一个类型。它有如下的定义
2016-01-18 01:53:55 +00:00
2016-01-21 02:22:10 +00:00
<u><i>net/http</i></u>
2016-01-13 15:23:42 +00:00
```go
package http
type HandlerFunc func(w ResponseWriter, r *Request)
func (f HandlerFunc) ServeHTTP(w ResponseWriter, r *Request) {
2016-01-18 02:52:21 +00:00
f(w, r)
2016-01-13 15:23:42 +00:00
}
```
2016-01-18 01:53:55 +00:00
HandlerFunc显示了在Go语言接口机制中一些不同寻常的特点。这是一个实现了接口http.Handler的方法的函数类型。ServeHTTP方法的行为是调用了它的函数本身。因此HandlerFunc是一个让函数值满足一个接口的适配器这里函数和这个接口仅有的方法有相同的函数签名。实际上这个技巧让一个单一的类型例如database以多种方式满足http.Handler接口一种通过它的list方法一种通过它的price方法等等。
2016-01-13 15:23:42 +00:00
2016-02-15 03:06:34 +00:00
因为handler通过这种方式注册非常普遍ServeMux有一个方便的HandleFunc方法它帮我们简化handler注册代码成这样
2016-01-18 01:53:55 +00:00
2016-01-21 02:22:10 +00:00
<u><i>gopl.io/ch7/http3a</i></u>
2016-01-13 15:23:42 +00:00
```go
mux.HandleFunc("/list", db.list)
mux.HandleFunc("/price", db.price)
```
2016-01-18 01:53:55 +00:00
从上面的代码很容易看出应该怎么构建一个程序由两个不同的web服务器监听不同的端口并且定义不同的URL将它们指派到不同的handler。我们只要构建另外一个ServeMux并且再调用一次ListenAndServe可能并行的。但是在大多数程序中一个web服务器就足够了。此外在一个应用程序的多个文件中定义HTTP handler也是非常典型的如果它们必须全部都显式地注册到这个应用的ServeMux实例上会比较麻烦。
2016-01-13 15:23:42 +00:00
2016-02-15 03:06:34 +00:00
所以为了方便net/http包提供了一个全局的ServeMux实例DefaultServerMux和包级别的http.Handle和http.HandleFunc函数。现在为了使用DefaultServeMux作为服务器的主handler我们不需要将它传给ListenAndServe函数nil值就可以工作。
2016-01-13 15:23:42 +00:00
2016-02-15 03:06:34 +00:00
然后服务器的主函数可以简化成:
2016-01-18 01:53:55 +00:00
2016-01-21 02:22:10 +00:00
<u><i>gopl.io/ch7/http4</i></u>
2016-01-13 15:23:42 +00:00
```go
func main() {
2016-01-18 02:52:21 +00:00
db := database{"shoes": 50, "socks": 5}
http.HandleFunc("/list", db.list)
http.HandleFunc("/price", db.price)
log.Fatal(http.ListenAndServe("localhost:8000", nil))
2016-01-13 15:23:42 +00:00
}
```
2016-01-18 01:53:55 +00:00
最后一个重要的提示就像我们在1.7节中提到的web服务器在一个新的协程中调用每一个handler所以当handler获取其它协程或者这个handler本身的其它请求也可以访问到变量时一定要使用预防措施比如锁机制。我们后面的两章中将讲到并发相关的知识。
2016-01-13 15:23:42 +00:00
**练习 7.11** 增加额外的handler让客户端可以创建读取更新和删除数据库记录。例如一个形如 `/update?item=socks&price=6` 的请求会更新库存清单里一个货品的价格并且当这个货品不存在或价格无效时返回一个错误值。(注意:这个修改会引入变量同时更新的问题)
2016-01-13 15:23:42 +00:00
2018-06-09 16:27:25 +00:00
**练习 7.12** 修改/list的handler让它把输出打印成一个HTML的表格而不是文本。html/template包§4.6)可能会对你有帮助。