xfy
179aacac04
为各模块添加上下文文档，帮助 AI 助手理解代码结构： - AGENTS.md: 项目根目录上下文 - docs/AGENTS.md: 文档目录说明 - internal/AGENTS.md: 内部包结构概览 - 各子模块 AGENTS.md: 模块特定上下文和约定 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.1 KiB
1.1 KiB
middleware
Purpose
中间件框架，定义统一的中间件接口和链式组合机制。
Key Files
| File | Description |
|---|---|
middleware.go |
中间件接口和链：Middleware 接口、Chain 结构体、Apply 方法 |
For AI Agents
Working In This Directory
Middleware接口定义：Name() string和Process(next) RequestHandlerChain用于组合多个中间件，按注册顺序逆序包装Apply()从最后一个中间件开始包装，确保执行顺序正确- 后续阶段将添加具体中间件实现（安全、压缩、重写等）
Testing Requirements
- 运行测试：
go test ./internal/middleware/... - 测试链式组合和执行顺序
Common Patterns
- 中间件使用
fasthttp.RequestHandler函数签名 - 包装模式：
func(ctx) { preProcess(); next(ctx); postProcess() } - 空 Chain 的
Apply()直接返回原始 handler
Dependencies
External
github.com/valyala/fasthttp- HTTP 框架