feat: add TrieRouter

This commit is contained in:
yangshangbo
2025-07-04 16:12:14 +08:00
parent 763b2e62b5
commit 3764a640c4
6 changed files with 323 additions and 29 deletions
+35
View File
@@ -0,0 +1,35 @@
## Trie 路由树(高性能路由)
### 简介
Trie 路由树是一种高性能的路由匹配结构,广泛应用于现代 Web 框架。相比传统的正则遍历路由,Trie 路由树在大规模路由和高并发场景下具有更高的查找效率。
### 特性
- 支持静态路由、命名参数(如 `/user/:id`)、通配符(如 `/static/*filepath`)
- 支持正则路由(如 `/user/(?P<id>[^/]+)`),正则路由单独分流
- 路由树根节点按 HTTP 方法(GET/POST/PUT/DELETE)分流,进一步提升查找效率
- 内置 LRU 路由缓存,热点路由命中极快
- 性能测试显示 Trie 路由树在大规模动态路由下性能优于传统正则遍历
### 用法
注册路由时,框架会自动将路由注册到 Trie 路由树和 HybridRouter:
```v
app.get('/api/users/:id', fn (req hono.Request) http.Response {
return hono.Response.json('{"user_id": "${req.param["id"]}"}')
})
```
### 性能优势
- 静态路由、参数路由、通配符路由查找均为 O(n)(n为路径层级),极快
- 路由缓存命中时,查找仅需一次 map 查询,QPS 可达 20~30 万
- 支持上千条动态路由、百万级请求高并发场景
### 缓存说明
- Trie 路由树内置 LRU 缓存(默认容量1000),缓存 key 为 `method:path`,value 为 `RouteMatch`
- 命中缓存时性能极高,未命中时自动查找并写入缓存
- 可根据实际需求调整缓存容量
### 与 HybridRouter 对比
- HybridRouter 采用静态路由 map + 动态正则遍历,适合路由数量较少或兼容性需求高的场景
- TrieRouter 适合大规模路由、高并发、极致性能场景
- 两者可并存,便于灵活切换和对比测试