用途:在 Effect 项目中添加 HTTP 路由、路径参数与 JSON 响应,并把处理函数通过 layers 与各类服务连接,也适合实现小型代理或适配端点。
主要能力:基于 @effect/platform 的 HttpRouter 定义路由(如 HttpRouter.get / post),用 HttpServerResponse 返回 text、json、html 等响应,用 HttpRouter.params 读取路径参数;通过 HttpServer.serve 启动服务,并由 NodeHttpServer.layer 及依赖层提供服务实现。
必要用法:保持处理函数轻量——先解码校验、再调用服务、最后编码响应;用 Schema 做请求体与参数校验并返回结构化错误;依赖通过组合好的 App layer 一次注入。示例:HttpRouter.empty.pipe(HttpRouter.get("/ping", Effect.succeed(HttpResponse.text("pong"))))。
工作流程建议:先搜索本地 Effect 源码目录 docs/effect-source/(重点文件 HttpRouter.ts、HttpServer.ts、HttpServerResponse.ts、HttpServerRequest.ts),可用 grep 查找路由与响应模式,再参照测试文件编写代码。
限制与注意事项:避免跳过输入校验、避免在处理函数中做重活;相关资料未提供具体版本、安装命令与完整服务配置细节,暂未提供。