imicola net.http CRUD
net.http CRUD

net.http CRUD

596 字 · 约 1 分钟

引言

请先阅读 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 提及笔记
局部关系图谱 悬停高亮 · 点击跳转