net.http CRUD
引言
请先阅读 HTTP Method,以便理解下面的 Method 与 CRUD 映射。
上一篇文章 net.http入门 介绍了请求进入服务器后,如何经过路由和 Handler 构造响应。在实际服务中,我们还需要根据 HTTP Method 对资源执行创建、读取、更新和删除等操作。
在开始 CRUD 之前,需要先理解路由器的选择。
自定义路由器
上一篇文章使用了 http.ListenAndServe(":8080", nil)。其中第二个参数为 nil 时,服务器会使用全局的 http.DefaultServeMux。我们也可以显式创建并传入自己的路由器:
mux := http.NewServeMux()
mux.HandleFunc("/healthz", healthz)
http.ListenAndServe(":8080", mux)go这样,请求链会更加清晰:
客户端
│
│ GET /healthz
↓
HTTP Server(读取并解析请求)
│
↓
mux(根据 Method + Path 匹配 Handler)
│
↓
healthz
│
↓
ResponseWriter
│
↓
客户端这里需要注意:如果路由通过 http.HandleFunc 注册,它会进入 DefaultServeMux;如果服务器最终使用的是新建的 mux,请求就匹配不到这些路由。因此,注册路由和启动服务器必须使用同一个 ServeMux。
Go 1.22 之后的方法路由
在一些旧教程中,我们会看到下面的写法:
mux.HandleFunc("/targets", targetsHandler)
func targetsHandler(w http.ResponseWriter, r *http.Request) {
switch r.Method {
case http.MethodGet:
// 查询
case http.MethodPost:
// 创建
default:
// 405
}
}go从 Go 1.22 开始,标准库 ServeMux 的 pattern 支持 Method 和路径通配符,因此可以写成:
mux.HandleFunc("GET /targets", listTarget)
mux.HandleFunc("POST /targets", addTarget)
mux.HandleFunc("GET /targets/{id}", getTarget)
mux.HandleFunc("PUT /targets/{id}", updateTarget)
mux.HandleFunc("DELETE /targets/{id}", deleteTarget)go本文示例统一使用复数资源路径 /targets,而当前 sentinel-go 代码仍使用 /target。两种路径都能被路由器处理,但同一个项目应统一代码、README、测试和笔记中的接口契约,避免调用时混用。
HTTP Server 负责读取并解析原始请求,ServeMux 接收解析后的 *http.Request,再根据 Method、Host 和 Path 选择 Handler。换句话说,ServeMux 是请求多路复用器,而不是 HTTP 报文解析器。
{id} 只匹配一个路径段,可以通过 r.PathValue("id") 读取,返回值类型是 string。另外,"GET /targets/{id}" 也会匹配 HEAD 请求;当 Path 能匹配、Method 不能匹配时,ServeMux 会返回 405 Method Not Allowed。
当前实现边界
当前 sentinel-go 使用内存 map 保存 Target,因此服务重启后数据会丢失。net/http 会并发处理请求,而普通 map 与自增 ID 计数器不能安全地被多个请求同时读写;后续需要引入互斥保护并使用 go test -race 验证。自动化测试、服务超时和优雅退出也尚未完成。
参考资料
知识关联
0 反向链接 · 2 提及笔记反向链接0
暂无其他笔记引用本篇