SuperAPI AI 工具集

relic-middleware

通用与其它

查看项目

更新于 10-16 05:54

技能介绍

用途:在 Relic 中创建并应用中间件,处理鉴权、CORS、日志等横切关注点;用上下文属性传递类型安全的请求级数据。

主要能力:中间件可检查或修改请求、转换响应、提前返回短路或捕获错误。定义形式为 typedef Middleware = Handler Function(Handler innerHandler),返回闭包,在 await innerHandler(req) 前后插入逻辑。示例含鉴权(检查 X-API-Key,失败返回 Response.unauthorized)、CORS(处理 OPTIONS 并添加响应头)、错误处理(try/catch 返回 internalServerError)与追加响应头。

用法:通过 router.use(path, middleware) 应用,可全局 use('/') 或按路径 use('/api') 限定;中间件只对已注册路由生效,未匹配请求(404)直接进入 fallback。执行顺序按路径层级优先,同路径内按注册顺序,响应按相反顺序回流。ContextProperty<T> 提供请求作用域存储,可读写并在 handler 中通过扩展方法访问;Relic 还内置 pathParameters、queryParameters、router、matchedPath、remainingPath 等属性。

限制:Pipeline 为 Shelf 遗留组合方式,新代码应优先 router.use();Pipeline 对所有请求(含 404)运行中间件,router.use() 只对匹配路由运行。文档未提供安装方式、版本、性能或收费信息。