目录

方法匹配(Method Matching)

通配符(Wildcards)

路径前缀匹配

优先规则

兼容性

API 变更

小结

参考资料

Go 1.22 版本对 net/http 包的路由功能进行了增强,引入了方法匹配(method matching)和通配符(wildcards)两项新功能,这些特性使得开发者能够使用模式字符串来表达常见的路由,而不需要直接编写 Go 代码。

方法匹配(Method Matching)

现在可以在模式字符串中指定 HTTP 方法,使路由器能够区分同一 URL 模式下的不同方法(如 GET、POST 等)。如果有一个处理 GET 请求的路由,在Go 1.22之前,可能会这样写路由:

http.Handle("/posts/", handlePost)

会匹配所有以 /posts/ 开头的请求,而 handlePost 函数需要额外解析 ID 并检查 HTTP 方法。

在 Go 1.22 中,可以在路由模式中指定 HTTP 方法。可以这样写:

http.Handle("GET /posts/{id}", handlePost2)

这里的  {id} 是一个通配符,将匹配路径中的任何部分。handlePost2 函数不再需要检查 HTTP 方法,因为路由已经确保了只有 GET 请求会被匹配。可以通过 PathValue 方法从 Request 对象中提取通配符的值:

idString := req.PathValue("id")

通配符(Wildcards)

模式中可以包含通配符,用以匹配可变的路径段。通配符 {} 可以匹配路径中的一个部分,而 {...} 可以匹配路径中的剩余部分。例如,/files/{pathname...} 可以匹配 /files/ 后面的任何路径。

路径前缀匹配

如果想要匹配一个确切的路径,包括路径末尾的斜杠,可以这样写:

http.Handle("/posts/{$}", handlePosts)

这将匹配 /posts/ 但不会匹配 /posts 或 /posts/234。

优先规则

当多个模式匹配同一个请求时,确定哪个模式具有优先权是一个比较有挑战性的问题。Go 1.22 采用了基于特定性的规则:

如果一个模式匹配的请求集是另一个模式的严格子集,则认为它更具体。最具体的模式具有优先权。如果两个模式重叠但没有一个是更具体的,则视为冲突,注册这两个模式会引发 panic。

例如,/posts/latest 比 /posts/{id} 更具体,因为它精确匹配一个路径,而后者匹配任何以/posts/ 开头的路径。

例如,/posts/{id} 和 /{resource}/latest 都可以匹配 /posts/latest,这两种模式区分不出哪个更优先,所以注册这两个路由会引发 panic。

兼容性

Go 1.22 努力保持与旧版本的兼容性,新的模式语法是旧语法的超集,所以升级到1.22后代码功能依然是正常的。但是,有一些边缘情况需要注意,例如,旧版本的 Go 会将带有大括号的模式视为字面量,而 Go 1.22 将大括号用于通配符,可以通过设置 GODEBUG 环境变量的值为 httpmuxgo121 来恢复旧版本的行为。

API 变更

net/http.Request 新增了两个方法:

PathValue,用于从请求路径中提取通配符的值。SetPathValue,允许标准库之外的路由器通过 PathValue 使通配符匹配结果可用。

小结

这些对 net/http 包的增强使得 Go 的标准库在构建具有复杂路由需求的 Web 服务的功能更加强大,减少了许多用例对第三方框架的需求。然而,对于具有更高级路由需求的应用程序,第三方框架仍然是很好的选择。Go 团队通过研究第三方框架、提取常用功能并与社区互动的方式来集成这些特性,展现了对满足用户需求和尊重向后兼容原则的承诺。

参考资料

Routing Enhancements for Go 1.22 [https://go.dev/blog/routing-enhancements]

好文阅读

评论可见,请评论后查看内容,谢谢!!!
 您阅读本篇文章共花了: