Go / 系统课时
从 Handler 处理一个请求
从 Handler 处理一个请求
一个可用的 HTTP 服务可以先从最小 Handler 开始:读取请求方法、路径和查询参数,再通过 ResponseWriter 返回结构化 JSON。掌握这一条请求链路后,再扩展路由、中间件和业务逻辑会更稳。
学习目标
- 理解
http.Handler与http.HandlerFunc的职责 - 从
http.Request读取基础请求信息 - 正确设置响应头并返回 JSON 结果
Handler 的最小职责
Go 的 HTTP 处理核心是 ServeHTTP(http.ResponseWriter, *http.Request)。http.HandlerFunc 只是一个适配器,可以把普通函数转换成 Handler,因此小型接口通常直接注册函数,复杂服务再把状态封装进结构体。
Handler 每次只处理一个请求,但同一个 Handler 可能被多个请求并发调用,所以不要把“当前请求”的临时数据放进共享全局变量。请求级数据应来自 *http.Request 或函数内部局部变量。
写一个最小结构化响应服务
下面的程序注册 /inspect 路由,只接受 GET 请求,并把请求方法、路径和查询参数 q 返回为 JSON。
package main
import (
"encoding/json"
"log"
"net/http"
)
type response struct {
Method string `json:"method"`
Path string `json:"path"`
Query string `json:"query"`
}
func inspectHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != http.MethodGet {
http.Error(w, "method not allowed", http.StatusMethodNotAllowed)
return
}
payload := response{
Method: r.Method,
Path: r.URL.Path,
Query: r.URL.Query().Get("q"),
}
w.Header().Set("Content-Type", "application/json; charset=utf-8")
if err := json.NewEncoder(w).Encode(payload); err != nil {
log.Printf("encode response: %v", err)
}
}
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/inspect", inspectHandler)
addr := ":8080"
log.SetFlags(0)
log.Printf("listening on %s", addr)
if err := http.ListenAndServe(addr, mux); err != nil {
log.Fatal(err)
}
}预期输出
listening on :8080保持服务运行,再发起一次请求:
curl -s "http://127.0.0.1:8080/inspect?q=go"预期结果
{"method":"GET","path":"/inspect","query":"go"}json.Encoder 会在响应末尾追加换行,因此终端显示时可能在 JSON 后直接换到下一行;字段内容应与上面的请求一致。
从 Request 里读取什么
本例只读取三个最常用位置:r.Method 表示 HTTP 方法,r.URL.Path 表示路由路径,r.URL.Query() 解析查询字符串。它们都属于已经由 net/http 解析好的请求元数据,不需要自己拆原始 HTTP 报文。
如果后续要读取 JSON 请求体,应先限制允许的方法和请求体大小,再使用 json.Decoder 解码。不要在还没有明确接口契约时同时读取表单、JSON 和任意二进制数据,否则错误处理会很快变得混乱。
ResponseWriter 的关键边界
调用 w.Header().Set 必须发生在第一次写响应体之前;一旦开始写响应体,默认状态码就是 200,响应头也基本确定。需要返回 4xx 或 5xx 时,应先确定错误,再写状态码和正文。
ResponseWriter 只在当前 ServeHTTP 调用期间有效,不要把它保存到 goroutine 中等 Handler 返回后再使用。如果确实需要异步任务,应先把请求所需数据复制出来,让 HTTP 响应在当前调用内完成。
一个合格的最小 Handler 至少要做到:路由明确、方法不匹配时返回可预期状态、成功响应声明正确的 Content-Type,并且每个请求只操作自己的局部数据。